[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
customXml (Inline-Level Custom XML Element)
This element specifies the presence of a custom XML element around one or more inline level structures (runs, images, fields, etc.) within a paragraph. The attributes on this element shall be used to specify the name and namespace URI of the current custom XML element.
[Example: Consider a custom XML element with the name firstName that shall be located around a two text runs in a WordprocessingML document. This requirement would be specified as follows in the WordprocessingML:
<w:p>
<w:customXml w:element="firstName" … >
<w:r>
…
</w:r>
<w:r>
…
</w:r>
</w:customXml>
…
</w:p>
The customXml element specifies that the name of the custom XML element is firstName, and the custom XML element contains a two text runs (it is an inline-level element). end example]
|
Parent Elements |
|
customXml (§2.5.1.5); del (§2.13.5.12); fldSimple (§2.16.21); hyperlink (§2.16.24); ins (§2.13.5.20); moveFrom (§2.13.5.21); moveTo (§2.13.5.26); p (§2.3.1.22); sdtContent (§2.5.2.35); smartTag (§2.5.1.9) |
|
Child Elements |
Subclause |
|
bookmarkEnd (Bookmark End) |
§2.13.6.1 |
|
bookmarkStart (Bookmark Start) |
§2.13.6.2 |
|
commentRangeEnd (Comment Anchor Range End) |
§2.13.4.3 |
|
commentRangeStart (Comment Anchor Range Start) |
§2.13.4.4 |
|
§2.5.1.5 | |
|
customXmlDelRangeEnd (Custom XML Markup Deletion End) |
§2.13.5.4 |
|
customXmlDelRangeStart (Custom XML Markup Deletion Start) |
§2.13.5.5 |
|
customXmlInsRangeEnd (Custom XML Markup Insertion End) |
§2.13.5.6 |
|
customXmlInsRangeStart (Custom XML Markup Insertion Start) |
§2.13.5.7 |
|
customXmlMoveFromRangeEnd (Custom XML Markup Move Source End) |
§2.13.5.8 |
|
customXmlMoveFromRangeStart (Custom XML Markup Move Source Start) |
§2.13.5.9 |
|
customXmlMoveToRangeEnd (Custom XML Markup Move Destination Location End) |
§2.13.5.10 |
|
customXmlMoveToRangeStart (Custom XML Markup Move Destination Location Start) |
§2.13.5.11 |
|
customXmlPr (Custom XML Element Properties) |
§2.5.1.7 |
|
§2.13.5.12 | |
|
fldSimple (Simple Field) |
§2.16.21 |
|
hyperlink (Hyperlink) |
§2.16.24 |
|
§2.13.5.20 | |
|
§2.13.5.21 | |
|
moveFromRangeEnd (Move Source Location Container - End) |
§2.13.5.23 |
|
moveFromRangeStart (Move Source Location Container - Start) |
§2.13.5.24 |
|
§2.13.5.26 | |
|
moveToRangeEnd (Move Destination Location Container - End) |
§2.13.5.27 |
|
moveToRangeStart (Move Destination Location Container - Start) |
§2.13.5.28 |
|
oMath (Office Math) |
§7.1.2.77 |
|
oMathPara (Math Paragraph) |
§7.1.2.78 |
|
permEnd (Range Permission End) |
§2.13.7.1 |
|
permStart (Range Permission Start) |
§2.13.7.2 |
|
proofErr (Proofing Error Anchor) |
§2.13.8.1 |
|
r (Text Run) |
§2.3.2.23 |
|
sdt (Inline-Level Structured Document Tag) |
§2.5.2.29 |
|
smartTag (Inline-Level Smart Tag) |
§2.5.1.9 |
|
subDoc (Anchor for Subdocument Location) |
§2.17.2.1 |
|
Attributes |
Description |
|
element (Element name) |
Specifies the name of the current custom XML element or smart tag within the document.
[Example: Consider a custom XML element which shall have a name of companyName. This requirement would be specified using the following WordprocessingML:
<w:customXml w:element="companyName" … >
The element attribute specifies that the name for this element shall be companyName. end example]
The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
|
uri (Custom XML Markup Namespace) |
Specifies the namespace URI of the current custom XML element or smart tag.
If this attribute is omitted, the URI shall be assumed to be null (no associated URI).
[Example: Consider a custom XML element which shall have a namespace URI of urn:customXmlExample. This requirement would be specified using the following WordprocessingML:
<w:customXml … w:uri="urn:customXmlExample" />
The uri attribute specifies that the namespace for this element shall be urn:customXmlExample. end example]
The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_CustomXmlRun">
<sequence>
<element name="customXmlPr" type="CT_CustomXmlPr" minOccurs="0" maxOccurs="1"/>
<group ref="EG_PContent" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="uri" type="ST_String"/>
<attribute name="element" type="ST_String" use="required"/>
</complexType>