<customXmlMoveToRangeEnd> (Custom XML Markup Move Destination Location End)

This element specifies the end of a region within which all custom XML markup was moved to this location in the document and this move was tracked as a revision. The @id attribute on this element shall be used to link this element with the corresponding custom XML move destination start marker in the document.

Providing a physical representation of the start and end tags of custom XML markup results in regions which can be inserted and deleted independently, but cannot be encapsulated by a single revision element, since their representation in WordprocessingML is the start or end XML tag for the custom XML markup which it represents. Therefore, the start/end "cross structure" annotation format surrounds the WordprocessingML region to which this move destination applies.

The following restrictions shall be applied to this element:

  • If this element occurs without a corresponding <customXmlMoveToRangeStart> element (§2.13.5.11) with a matching @id attribute value, then it shall be ignored and no move destination information shall be applied to the custom XML elements by this element.

  • If this element and its paired start encapsulate a range with no custom XML markup, then they shall be ignored and may be omitted when the document is subsequently saved.

  • If this element and its paired start occur outside of a valid move source container (§2.13.5.24; §2.13.5.23) with a matching move destination container (§2.13.5.28; §2.13.5.27), then custom XML markup in this region shall be treated as if it was inserted

  • If multiple end elements exist with the same @id attribute value, then the first instance in the document shall be used and subsequent elements should be treated as unmatched (no corresponding start).

example: 
<w:body>
  <w:p/>
  <w:customXml … >
    <w:p/>
  </w:customXml>
  <w:p/>
</w:body>

If the second paragraph is moved to the end of the document with revisions enabled. This revision must therefore be stored using the custom XML markup revision "cross structure" syntax, as follows:

<w:body>
  <w:p/>
  <w:moveFromRangeStart w:id="0" w:name="move1" w:displacedByCustomXml="next"/>
  <w:customXmlMoveFromRangeStart w:id="1"/>
  <w:customXml … >
    <w:p/>
  </w:customXml>
  <w:customXmlMoveFromRangeEnd w:id="1"/>
  <w:moveFromRangeEnd w:id="0" w:displacedByCustomXml="prev"/>
  <w:p/>
  <w:moveToRangeStart w:id="2" w:name="move1" w:displacedByCustomXml="next"/>
  <w:customXmlMoveToRangeStart w:id="3"/>
  <w:customXml … >
    <w:p/>
  </w:customXml>
  <w:customXmlMoveToRangeEnd w:id="3"/>
  <w:moveFromRangeEnd w:id="2" w:displacedByCustomXml="prev"/>
</w:body>

The <customXmlMoveToRangeEnd> element delimits the end of the region in which all custom XML elements have been moved to this location with revisions enabled. Since this element only affects custom XML, any text in the region is not revision marked moved by this element when present, but the corresponding physical characters for the custom XML element are. ]

Parent Elements

<body> (§2.2.2); <comment> (§2.13.4.2); <customXml> (§2.5.1.3); <customXml> (§2.5.1.4); <customXml> (§2.5.1.5); <customXml> (§2.5.1.6); <deg> (§7.1.2.26); <del> (§2.13.5.12); <den> (§7.1.2.28); <docPartBody> (§2.12.6); <e> (§7.1.2.32); <endnote> (§2.11.2); <fldSimple> (§2.16.21); <fName> (§7.1.2.37); <footnote> (§2.11.10); <ftr> (§2.10.3); <hdr> (§2.10.4); <hyperlink> (§2.16.24); <ins> (§2.13.5.20); <lim> (§7.1.2.52); <moveFrom> (§2.13.5.21); <moveTo> (§2.13.5.26); <num> (§7.1.2.75); <oMath> (§7.1.2.77); <p> (§2.3.1.22); <rt> (§2.3.3.23); <rubyBase> (§2.3.3.26); <sdtContent> (§2.5.2.32); <sdtContent> (§2.5.2.33); <sdtContent> (§2.5.2.34); <sdtContent> (§2.5.2.35); <smartTag> (§2.5.1.9); <sub> (§7.1.2.112); <sup> (§7.1.2.114); <tbl> (§2.4.36); <tc> (§2.4.62); <tr> (§2.4.75); <txbxContent> (§2.17.1.1)

Attributes

Description

<id> (Annotation Identifier)

Specifies a unique identifier for an annotation within a WordprocessingML document. The restrictions on the @id attribute, if any, are defined by the parent XML element.

If this attribute is omitted, then the document is non-conformant.

<w:… w:id="1" … >
  …
</w:…>

The <id> attribute specifies that the ID of the current annotation is 1. This value is used to uniquely identify this annotation within the document content. ]

The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16).

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

<complexType name="CT_Markup">
	<attribute name="id" type="ST_DecimalNumber" use="required"/>
</complexType>