<fldSimple> (Simple Field)

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:
<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. ]

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

<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

<del> (Deleted Run Content)

§2.13.5.12

<fldData> (Custom Field Data)

§2.16.20

<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

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

[: 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. ]

If this attribute is omitted, then its value shall be assumed to be false.

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

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.

<w:fldSimple w:instr="AUTHOR" w:fldLock="true">
  <w:r>
    <w:t>Rex Jaeschke</w:t>
  </w:r>
</w:fldSimple>

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

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.

<w:fldSimple w:instr="AUTHOR" w:fldLock="true">
  <w:r>
    <w:t>Rex Jaeschke</w:t>
  </w:r>
</w:fldSimple>

The @instr attribute specifies the field codes for this simple field to be AUTHOR. ]

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>