[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
This element specifies the presence of a simple field at the current location in the document. The semantics of this field are defined via its field codes (§2.16.5).
[Example: Consider the following WordprocessingML fragment for a simple field:
<w:fldSimple w:instr="FILENAME">
<w:r>
<w:t>Example Document.docx</w:t>
</w:r>
</w:fldSimple>
The fldSimple element defines a FILENAME field (§2.16.5.23) using the simple field syntax. The current field result for the field is Example Document.docx. end example]
Parent Elements |
customXml (§2.5.1.5); fldSimple (§2.16.21); hyperlink (§2.16.24); 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 |
§2.13.5.12 | |
fldData (Custom Field Data) |
§2.16.20 |
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 |
dirty (Field Result Invalidated) |
Specifies that this field has been flagged by an application to indicate that its current results are invalid (stale) due to other modifications made to the document, and these contents should be updated before they are displayed if this functionality is supported by the next processing application.
[Rationale: This functionality allows applications with limited subsets of the full functionality of this Office Open XML Standard to process Word Open XML documents without needing to understand and update all fields based on the semantics for their field codes.
For example, an application can add a new paragraph and flag the table of contents as dirty, without needing to understand anything about how to recalculate that field's content. end rationale]
If this attribute is omitted, then its value shall be assumed to be false.
[Example: Consider the following WordprocessingML for a simple field:
<w:fldSimple w:instr="AUTHOR" w:dirty="true"/> The dirty attribute value of true specifies that the contents of this field are no longer current based on the contents of the document, and should be recalculated whenever an application with this functionality reads the document. end example]
The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
fldLock (Field Should Not Be Recalculated) |
Specifies that the parent field shall not have its field result recalculated, even if an application attempts to recalculate the results of all fields in the document or a recalculation is explicitly requested.
If this attribute is omitted, then its value shall be assumed to be false.
[Example: Consider the following WordprocessingML for a simple field:
<w:fldSimple w:instr="AUTHOR" w:fldLock="true"> <w:t>Rex Jaeschke</w:t>
The fldLock attribute value of true specifies that the contents of this field shall remain Rex Jaeschke regardless of the actual result of the current field codes. end example]
The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
instr (Field Codes) |
Specifies the field codes for the simple field. The possible field codes are defined in §2.16.5.
[Example: Consider the following WordprocessingML for a simple field:
<w:fldSimple w:instr="AUTHOR" w:fldLock="true"> <w:t>Rex Jaeschke</w:t>
The instr attribute specifies the field codes for this simple field to be AUTHOR. 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_SimpleField">
<sequence>
<element name="fldData" type="CT_Text" minOccurs="0" maxOccurs="1"/>
<group ref="EG_PContent" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="instr" type="ST_String" use="required"/>
<attribute name="fldLock" type="ST_OnOff"/>
<attribute name="dirty" type="ST_OnOff"/>
</complexType>