[Table of Contents] [docx version]

VML Reference Material - VML

regrouptable (Shape Grouping History)

This element specifies a list of entries which describe how shapes were previously grouped so they can be regrouped. The regroupid attribute of shapes indicates which shapes belong together when a regroup is performed. The regrouptable tracks the previous regroupid that should be assigned to all shapes with the given current regroupid.

[Example: Consider a document containing two rectangles and a circle. The rectangles are grouped together, then that group is grouped with the circle. This new group is then ungrouped, leaving the circle and grouped rectangles. The document might contain the following snippets:

<v:oval ... o:regroupid="1"/>

<v:group ... o:regroupid="1"/>

<v:rect ... />

<v:rect ... />



<o:regrouptable v:ext="edit">

<o:entry new="1" old="0"/>


The regroupid attribute indicates that the shapes with regroupid 1 were previously grouped together. The entry indicates that if those shapes are regrouped, the new group formed should not have a regroupid value as it was not previously ungrouped.

If the two rectangles are ungrouped, the document reflects that the rectangles were previously grouped and that their old group was previously grouped:

<v:oval ... o:regroupid="1"/>

<v:rect ... o:regroupid="2"/>

<v:rect ... o:regroupid="2"/>


<o:regrouptable v:ext="edit">

<o:entry new="1" old="0"/>

<o:entry new="2" old="1"/>


end example]

Parent Elements



Child Elements


entry (Regroup Entry)





ext (VML Extension Handling Behavior)


Namespace: urn:schemas-microsoft-com:vml

Specifies an optional value that indicates how applications that implement VML should interpret extensions not defined as part of the original specification of core VML.


[Rationale: This part of the original VML specification is included to assist applications that leverage existing VML support in implementing the Office Open XML Format. end rationale]


The possible values for this attribute are defined by the ST_Ext simple type (§

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_RegroupTable">


   <element name="entry" type="CT_Entry" minOccurs="0" maxOccurs="unbounded"/>


   <attributeGroup ref="v:AG_Ext"/>