3.1.3.1.2 fldSimple (Ruby 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 ("[ISO/IEC-29500-1] §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 ("[ISO/IEC-29500-1] §17.16.5.17; FILENAME") using the simple field syntax. The current field result for the field is Example Document.docx. end example]

Parent Elements

customXml3.1.3.1.1, customXml); fldSimple (§3.1.3.1.2, fldSimple); hyperlink3.1.3.1.3, hyperlink); rt ("[ISO/IEC-29500-1] §17.3.3.24"); rubyBase ("[ISO/IEC-29500-1] §17.3.3.27"); sdtContent3.1.3.1.7, sdtContent)

Child Elements

Subclause

acc (Accent)

"[ISO/IEC-29500-1] §22.1.2.1"

bar (Bar)

"[ISO/IEC-29500-1] §22.1.2.7"

bookmarkEnd (Bookmark End)

"[ISO/IEC-29500-1] §17.13.6.1"

bookmarkStart (Bookmark Start)

"[ISO/IEC-29500-1] §17.13.6.2"

borderBox (Border-Box Object)

"[ISO/IEC-29500-1] §22.1.2.11"

box (Box Object)

"[ISO/IEC-29500-1] §22.1.2.13"

commentRangeEnd (Comment Anchor Range End)

"[ISO/IEC-29500-1] §17.13.4.3"

commentRangeStart (Comment Anchor Range Start)

"[ISO/IEC-29500-1] §17.13.4.4"

customXml (Ruby Inline-Level Custom XML Element)

§3.1.3.1.1, customXml

customXmlDelRangeEnd (Custom XML Markup Deletion End)

"[ISO/IEC-29500-1] §17.13.5.4"

customXmlDelRangeStart (Custom XML Markup Deletion Start)

"[ISO/IEC-29500-1] §17.13.5.5"

customXmlInsRangeEnd (Custom XML Markup Insertion End)

"[ISO/IEC-29500-1] §17.13.5.6"

customXmlInsRangeStart (Custom XML Markup Insertion Start)

"[ISO/IEC-29500-1] §17.13.5.7"

customXmlMoveFromRangeEnd (Custom XML Markup Move Source End)

"[ISO/IEC-29500-1] §17.13.5.8"

customXmlMoveFromRangeStart (Custom XML Markup Move Source Start)

"[ISO/IEC-29500-1] §17.13.5.9"

customXmlMoveToRangeEnd (Custom XML Markup Move Destination Location End)

"[ISO/IEC-29500-1] §17.13.5.10"

customXmlMoveToRangeStart (Custom XML Markup Move Destination Location Start)

"[ISO/IEC-29500-1] §17.13.5.11"

d (Delimiter Object)

"[ISO/IEC-29500-1] §22.1.2.24"

del (Deleted Run Content)

"[ISO/IEC-29500-1] §17.13.5.14"

eqArr (Array Object)

"[ISO/IEC-29500-1] §22.1.2.34"

f (Fraction Object)

"[ISO/IEC-29500-1] §22.1.2.36"

fldData (Custom Field Data)

"[ISO/IEC-29500-4] §14.9.6"

fldSimple (Ruby Simple Field)

§3.1.3.1.2, fldSimple

func (Function Apply Object)

"[ISO/IEC-29500-1] §22.1.2.39"

groupChr (Group-Character Object)

"[ISO/IEC-29500-1] §22.1.2.41"

hyperlink (Ruby Hyperlink)

§3.1.3.1.3, hyperlink

ins (Inserted Run Content)

"[ISO/IEC-29500-1] §17.13.5.18"

limLow (Lower-Limit Object)

"[ISO/IEC-29500-1] §22.1.2.54"

limUpp (Upper-Limit Object)

"[ISO/IEC-29500-1] §22.1.2.56"

m (Matrix Object)

"[ISO/IEC-29500-1] §22.1.2.60"

moveFrom (Move Source Run Content)

"[ISO/IEC-29500-1] §17.13.5.22"

moveFromRangeEnd (Move Source Location Container - End)

"[ISO/IEC-29500-1] §17.13.5.23"

moveFromRangeStart (Move Source Location Container - Start)

"[ISO/IEC-29500-1] §17.13.5.24"

moveTo (Move Destination Run Content)

"[ISO/IEC-29500-1] §17.13.5.25"

moveToRangeEnd (Move Destination Location Container - End)

"[ISO/IEC-29500-1] §17.13.5.27"

moveToRangeStart (Move Destination Location Container - Start)

"[ISO/IEC-29500-1] §17.13.5.28"

nary (n-ary Operator Object)

"[ISO/IEC-29500-1] §22.1.2.70"

oMath (Office Math)

"[ISO/IEC-29500-1] §22.1.2.77"

oMathPara (Office Math Paragraph)

"[ISO/IEC-29500-1] §22.1.2.78"

permEnd (Range Permission End)

"[ISO/IEC-29500-1] §17.13.7.1"

permStart (Range Permission Start)

"[ISO/IEC-29500-1] §17.13.7.2"

phant (Phantom Object)

"[ISO/IEC-29500-1] §22.1.2.81"

proofErr (Proofing Error Anchor)

"[ISO/IEC-29500-1] §17.13.8.1"

r (Run)

"[ISO/IEC-29500-1] §22.1.2.87"

r (Text Run)

"[ISO/IEC-29500-1] §17.3.2.25"

rad (Radical Object)

"[ISO/IEC-29500-1] §22.1.2.88"

sdt (Ruby Inline-Level Structured Document Tag)

§3.1.3.1.6, sdt

sPre (Pre-Sub-Superscript Object)

"[ISO/IEC-29500-1] §22.1.2.99"

sSub (Subscript Object)

"[ISO/IEC-29500-1] §22.1.2.101"

sSubSup (Sub-Superscript Object)

"[ISO/IEC-29500-1] §22.1.2.103"

sSup (Superscript Object)

"[ISO/IEC-29500-1] §22.1.2.105"

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 ISO/IEC-29500 Office Open XML File Formats [ISO/IEC29500:2012] to process 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 (§3.1.3.3.6, ST_OnOff).

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 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 (§3.1.3.3.6, ST_OnOff).

instr (Field Codes)

Specifies the field codes for the simple field. The possible field codes are defined in "[ISO/IEC-29500-1] §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 (§3.1.3.3.8, ST_String).

The following XML Schema fragment defines the contents of this element:

 <complexType name="CT_SimpleFieldRuby">
   <sequence>
     <element name="fldData" type="CT_Text" minOccurs="0" maxOccurs="1"/>
     <group ref="EG_RubyContent" 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>
Show: