<anchor>
(Anchor for Floating DrawingML Object)
This element specifies that the DrawingML object located at this position in the document is a floating object. Within a WordprocessingML document, drawing objects can exist in two states:
Inline - The drawing object is in line with the text, and affects the line height and layout of its line (like a character glyph of similar size).
Floating - The drawing object is anchored within the text, but may be absolutely positioned in the document relative to the page.
When this element encapsulates the DrawingML object's information, then all child elements shall dictate the positioning of this object as a floating object on the page.
<w:p>
<w:r>
<w:drawing>
<wp:anchor … >
…
</wp:anchor>
</w:drawing>
</w:r>
</w:p>
The <anchor>
element, when present as the child element of the <drawing>
element, specifies that this DrawingML object shall be positioned as a floating object based on the values of its child elements. ]
Parent Elements |
---|
|
Child Elements |
Subclause |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Attributes |
Description |
---|---|
|
Specifies whether a DrawingML object which intersects another DrawingML object at display time shall be allowed to overlap the contents of the other DrawingML object. If a DrawingML object cannot overlap other DrawingML object, it shall be repositioned when displayed to prevent this overlap as needed. If this element is omitted on a given DrawingML object, then overlap shall not be allowed between a DrawingML object which intersects another DrawingML object displayed at the same location. <wp:anchor allowOverlap="true" … > … </wp:anchor> The The possible values for this attribute are defined by the XML Schema boolean datatype. |
|
Specifies whether this floating DrawingML object shall be displayed behind the text of the document when the document is displayed. When a DrawingML object is displayed within a WordprocessingML document, that object may intersect with text in the document. This attribute shall determine whether the text or the object shall be rendered on top in case of overlapping. If this attribute is omitted, then the parent DrawingML object shall be displayed in front of the text content of the document in cases of overlapping. <wp:anchor behindDoc="false" … > … </wp:anchor> The The possible values for this attribute are defined by the XML Schema boolean datatype. |
|
Specifies the minimum distance which shall be maintained between the bottom edge of this drawing object and any subsequent text within the document when this graphical object is displayed within the document's contents. The distance shall be measured in EMUs (English Metric Units). If this object is an inline object (i.e. has a parent element of <wp:anchor distB="457200" … > … </wp:anchor> The The possible values for this attribute are defined by the ST_WrapDistance simple type (§5.5.3.6). |
|
Specifies the minimum distance which shall be maintained between the left edge of this drawing object and any subsequent text within the document when this graphical object is displayed within the document's contents. The distance shall be measured in EMUs (English Metric Units). If this object is an inline object (i.e. has a parent element of <wp:anchor distL="228600" … > … </wp:anchor> The The possible values for this attribute are defined by the ST_WrapDistance simple type (§5.5.3.6). |
|
Specifies the minimum distance which shall be maintained between the right edge of this drawing object and any subsequent text within the document when this graphical object is displayed within the document's contents. The distance shall be measured in EMUs (English Metric Units). If this object is an inline object (i.e. has a parent element of <wp:anchor distR="228600" … > … </wp:anchor> The The possible values for this attribute are defined by the ST_WrapDistance simple type (§5.5.3.6). |
|
Specifies the minimum distance which shall be maintained between the top edge of this drawing object and any subsequent text within the document when this graphical object is displayed within the document's contents. The distance shall be measured in EMUs (English Metric Units). If this object is an inline object (i.e. has a parent element of <wp:anchor distT="457200" … > … </wp:anchor> The The possible values for this attribute are defined by the ST_WrapDistance simple type (§5.5.3.6). |
|
Specifies whether this floating DrawingML object shall be displayed. When a DrawingML object is displayed within a WordprocessingML document, that object may be hidden (i.e. present, but not visible). This attribute shall determine whether the object shall be rendered or made hidden. [: An application may have settings which allow this object to be viewed. ] If this attribute is omitted, then the parent DrawingML object shall be displayed (i.e. not hidden). <wp:anchor hidden="true" … > … </wp:anchor> The The possible values for this attribute are defined by the XML Schema boolean datatype. |
|
Specifies how this DrawingML object shall behave when its anchor is located in a table cell; and its specified position would cause it to intersect with a table cell displayed in the document. That behavior shall be as follows:
If this attribute is omitted, then its default value shall be considered to be <wp:anchor layoutInCell="true" … > … </wp:anchor> The If the The possible values for this attribute are defined by the XML Schema boolean datatype. |
|
Specifies that the anchor location for this object shall not be modified at runtime when an application edits the contents of this document. [: An application might have automatic behaviors which reposition the anchor for a DrawingML object based on user interaction - for example, moving it from one page to another as needed. This element shall tell applications not to perform any such behaviors. ] If this attribute is omitted, then the anchor shall not be locked for the parent DrawingML object (i.e. a default value of <wp:anchor locked="true" … > … </wp:anchor> The The possible values for this attribute are defined by the XML Schema boolean datatype. |
|
Specifies the relative Z-ordering of all DrawingML objects in this document. Each floating DrawingML object shall have a Z-ordering value, which determines which object is displayed when any two objects intersect. Higher values shall indicate higher Z-order; lower values shall indicate lower Z-order. This attribute shall only indicate the Z-order with respect to other objects in the document which have an identical <wp:anchor relativeHeight="5" … > … </wp:anchor> … <wp:anchor relativeHeight="8" … > … </wp:anchor> The The possible values for this attribute are defined by the XML Schema unsignedInt datatype. |
|
Specifies that this object shall be positioned using the positioning information in the If this element is omitted, then this object shall not use the simple positioning information in the <wp:anchor simplePos="true" … > <wp:simplePos x="0" y="0" /> … </wp:anchor> The The possible values for this attribute are defined by the XML Schema boolean datatype. |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Anchor">
<sequence>
<element name="simplePos" type="a:CT_Point2D"/>
<element name="positionH" type="CT_PosH"/>
<element name="positionV" type="CT_PosV"/>
<element name="extent" type="a:CT_PositiveSize2D"/>
<element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
<group ref="EG_WrapType"/>
<element name="docPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
<element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties" minOccurs="0" maxOccurs="1"/>
<element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
</sequence>
<attribute name="distT" type="ST_WrapDistance" use="optional"/>
<attribute name="distB" type="ST_WrapDistance" use="optional"/>
<attribute name="distL" type="ST_WrapDistance" use="optional"/>
<attribute name="distR" type="ST_WrapDistance" use="optional"/>
<attribute name="simplePos" type="xsd:boolean"/>
<attribute name="relativeHeight" type="xsd:unsignedInt" use="required"/>
<attribute name="behindDoc" type="xsd:boolean" use="required"/>
<attribute name="locked" type="xsd:boolean" use="required"/>
<attribute name="layoutInCell" type="xsd:boolean" use="required"/>
<attribute name="hidden" type="xsd:boolean" use="optional"/>
<attribute name="allowOverlap" type="xsd:boolean" use="required"/>
</complexType>