Regroup Method

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Regroups the group that the specified shape range belonged to previously. Returns the regrouped shapes as a single Shape object.

expression.Regroup

expression   Required. An expression that returns one of the objects in the Applies To list.

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.

An error occurs if none of the shapes in the specified range were previously members of a group.

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.

Example

This example regroups the selected shapes in the active publication. If the shapes haven't been previously grouped and ungrouped, this example will fail.

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml">ActiveDocument.Selection.ShapeRange.<strong>Regroup</strong></pre>