17.18.13 ST_DisplacedByCustomXml

This simple type specifies the possible values for the location of a single custom XML element’s start and/or end tag relative to the location of an annotation tag in document order. This enumeration shall be used to specify that the parent annotation’s placement shall be directly linked with the location of the physical presentation of a custom XML element in the document.

[Example: Consider a paragraph with block level custom XML markup and two comment anchor annotations (one before and one after the custom XML element’s physical representation), as follows:

Since all three of these items are around the entire paragraph, they are stored outside of the paragraph. However, in order to ensure that their relative positions are stored correctly, any annotation which must be

displaced by the physical custom XML element specifies this information, resulting in the following WordprocessingML:

…
<w:commentRangeStart w:id="0" />
<w:commentRangeStart w:id="1" w:displacedByCustomXml="next" />
<w:customXml w:element="spec" … >
  <w:p>
    …
  </w:p>
</w:customXml>
…

The displacedByCustomXml attribute specifies that even though all three of these items are around the paragraph and is moved inside the paragraph to be represented physically, the comment with ID 0 must be inside the custom XML, but the comment with ID 1 must be displaced to stay outside of the relative location of the next custom XML element (the spec element). end example]

This simple type’s contents are a restriction of the W3C XML Schema string datatype.

This simple type is restricted to the values

listed in the following table:

Enumeration Value

Description

Specifies that this annotation anchor shall be displaced by the physical representation of the next element of custom XML markup in the document.

If no custom XML markup exists in the same paragraph and after this anchor, then this setting shall be ignored.

Specifies that this annotation anchor shall be displaced by the physical representation of the previous element of custom XML markup in the document.

If no custom XML markup exists in the same paragraph and directly before this anchor, then this setting shall be ignored.

[Note: The W3C XML Schema definition of this simple type’s content model (ST_DisplacedByCustomXml) is located in A.1. end note]