RegroupTable class

Office 2013 and later

Shape Grouping History. When the object is serialized out as xml, its qualified name is o:regrouptable.

Namespace:  DocumentFormat.OpenXml.Vml.Office
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

[ChildElementInfoAttribute(typeof(Entry))]
public class RegroupTable : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

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 … />
</v:group>
<o:regrouptable v:ext="edit">
  <o:entry new="1" old="0"/>
</o:regrouptable>

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"/>
</o:regrouptable>

end example]

Parent Elements

shapelayout (§14.2.2.29)

Child Elements

Subclause

entry (Regroup Entry)

§14.2.2.9

Attributes

Description

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 (§14.1.3.2).

[Note: The W3C XML Schema definition of this element’s content model (CT_RegroupTable) is located in §A.6.2. end note]

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: