[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

customXml2.5.1.5); del2.13.5.12); fldSimple2.16.21); hyperlink2.16.24); ins2.13.5.20); moveFrom2.13.5.21); moveTo2.13.5.26); p2.3.1.22); sdtContent2.5.2.35); smartTag2.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

customXml (Inline-Level Custom XML Element)

§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

del (Deleted Run Content)

§2.13.5.12

fldSimple (Simple Field)

§2.16.21

hyperlink (Hyperlink)

§2.16.24

ins (Inserted Run Content)

§2.13.5.20

moveFrom (Move Source Run Content)

§2.13.5.21

moveFromRangeEnd (Move Source Location Container - End)

§2.13.5.23

moveFromRangeStart (Move Source Location Container - Start)

§2.13.5.24

moveTo (Move Destination Run Content)

§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" … >

</w:customXml>

 

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 type2.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" />

</w:customXml>

 

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 type2.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>