17.16.19 fldSimple

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 (17.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 (17.16.5.17) using the simple field syntax. The current field result for the field is Example Document.docx. end example]

Attributes

dirty (Field Result Invalidated)

Specifies that this field has been flagged by an application to indicate that its current results are no longer correct (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 ISO/IEC 29500 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 (22.9.2.7).

instr (Field Codes)

Specifies the field codes for the simple field. The possible field codes are defined in 17.16.5.

[Example: Consider the following WordprocessingML for a simple field:

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

The possible values for this attribute are defined by the ST_String simple type (22.9.2.13).

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:r>
          <w:t>Rex Jaeschke</w:t>
      </w:r>
    </w:fldSimple>

The fldLock attribute value of true specifies that the contents of this field must remain

The possible values for this attribute are defined by the ST_OnOff simple type (22.9.2.7).

[Note: The W3C XML Schema definition of this element’s content model (CT_SimpleField) is located in A.1. end note]