[Table of Contents] [docx version]

VML Reference Material - VML

idmap (Shape ID Map)

This element specifies how shape IDs in the document have been generated. This is an optional element included to allow applications a mechanism for storing information they need to persist related to generating shape IDs.

Parent Elements





data (Shape IDs)

Specifies the data the application uses to generate shape IDs.


[Example: An application might choose to reserve blocks of shape ID numbers for each part in the package. Each block of 1024 shape IDs could be referred to by index and this index stored in the data attribute. The data value for a given part might then be:


<o:idmap v:ext="edit" data="1"/>


indicating that all the IDs in block 1 are reserved by this part ( meaning shape IDs from 1 to 1024 cannot be used ). The application's internal constraint would be that each part reserve a different set of IDs. Another part, that contains more shapes, might use:


<o:idmap v:ext="edit" data="2,3"/>


In this case, shape IDs from 1025 to 3072 [ 3 x 1024 ] cannot be used ).


Another implementation might choose to store more verbose information in this attribute. Yet another implementation might ignore this element completely.


end example]


The possible values for this attribute are defined by the XML Schema string datatype.

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_IdMap">

   <attributeGroup ref="v:AG_Ext"/>

   <attribute name="data" type="xsd:string" use="optional"/>