officefileapi-devexpress-dot-spreadsheet-dot-shapecollection-dot-groupshapes-x28-system-dot-collections-dot-generic-dot-ilist-devexpress-dot-spreadsheet-dot-shape-x29.md
Groups shapes into a shape group.
Namespace : DevExpress.Spreadsheet
Assembly : DevExpress.Spreadsheet.v25.2.Core.dll
NuGet Package : DevExpress.Spreadsheet.Core
Shape GroupShapes(
IList<Shape> shapes
)
Function GroupShapes(
shapes As IList(Of Shape)
) As Shape
| Name | Type | Description |
|---|---|---|
| shapes | IList<Shape> |
A collection of shapes to be grouped.
|
| Type | Description |
|---|---|
| Shape |
A shape group.
|
Use the Shape.ShapeType property to determine a drawing object’s type in ShapeCollection.
The shape group can contain nested shape groups.
Call the ShapeCollection.UngroupShapes method to split the shape group into individual shapes. The ShapeCollection.UngroupShapes method call does not split child shape groups into individual shapes.
The code sample below shows how to combine three shapes into a shape group using the ShapeCollection.GroupShapes method:
// Create three shapes.
Worksheet worksheet = spreadsheetControl1.Document.Worksheets[0];
Shape shape1 = worksheet.Shapes.AddShape(ShapeGeometryPreset.RectangularCallout, 100, 100, 300, 300);
Shape shape2 = worksheet.Shapes.AddShape(ShapeGeometryPreset.RegularPentagon, 450, 0, 300, 300);
Shape shape3 = worksheet.Shapes.AddTextBox(300, 500, 200, 200, "Shape Text");
// Combine them into a shape group.
Shape shapeGroup = worksheet.Shapes.GroupShapes(new Shape[] { shape1, shape2, shape3 });
' Create three shapes.
Dim worksheet As Worksheet = spreadsheetControl1.Document.Worksheets(0)
Dim shape1 As Shape = worksheet.Shapes.AddShape(ShapeGeometryPreset.RectangularCallout, 100, 100, 300, 300)
Dim shape2 As Shape = worksheet.Shapes.AddShape(ShapeGeometryPreset.RegularPentagon, 450, 0, 300, 300)
Dim shape3 As Shape = worksheet.Shapes.AddTextBox(300, 500, 200, 200, "Shape Text")
' Combine them into a shape group.
Dim shapeGroup As Shape = worksheet.Shapes.GroupShapes(New Shape() { shape1, shape2, shape3 })
See Also