ShapeRange.Regroup Method
Regroups the group that the specified shape range belonged to previously. Returns the regrouped shapes as a single Shape object.
Namespace: Microsoft.Office.Interop.PowerPoint
Assembly: Microsoft.Office.Interop.PowerPoint (in Microsoft.Office.Interop.PowerPoint.dll)
Syntax
'Declaration
Function Regroup As Shape
'Usage
Dim instance As ShapeRange
Dim returnValue As Shape
returnValue = instance.Regroup()
Shape Regroup()
Return Value
Type: Microsoft.Office.Interop.PowerPoint.Shape
Shape
Remarks
The Regroup method only restores the group for the first previously grouped shape it finds in the specified ShapeRange collection. Therefore, if the specified shape range contains shapes that previously belonged to different groups, only one of the groups will be restored.
Note that because a group of shapes is treated as a single shape, grouping and ungrouping shapes changes the number of items in the Shapes collection and changes the index numbers of items that come after the affected items in the collection.
Examples
This example regroups the shapes in the selection in the active window. If the shapes haven't been previously grouped and ungrouped, this example will fail.
ActiveWindow.Selection.ShapeRange.Regroup