[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

ffData (Form Field Properties)

This element specifies a set of properties which shall be associated with the parent form field within the document. This form field may be of any of the following types (with the associated field codes in parentheses):

Checkbox (FORMCHECKBOX)

Drop-down List (FORMDROPDOWN)

Text box (FORMTEXT)

If this element is present and the field codes for the document do not specify a form field of one of these types, then the document shall be considered invalid.

If this element is omitted, then the properties associated with the parent form field shall be determined based on their default values.

[Example: Consider the following WordprocessingML fragment for a text box form field:

<w:fldSimple w:instr="FORMTEXT">
<w:ffData>
<w:name w:val="TextTextBox" />
<w:enabled w:val="false"/>
<w:textInput>
<w:maxLength w:val="10" />
</w:textInput>
</w:ffData>
</w:fldSimple>

The ffData element specifies the set of properties for this text box form field; in this example, a form field name of TestTextBox via the name element (§2.16.28), a disabled state via the enabled element (§2.16.14), and a maximum character length of 10 characters via the maxLength element (§2.16.27). end example]

Parent Elements

fldChar2.16.18)

 

Child Elements

Subclause

calcOnExit (Recalculate Fields When Current Field Is Modified)

§2.16.6

checkBox (Checkbox Form Field Properties)

§2.16.7

ddList (Drop-Down List Form Field Properties)

§2.16.9

enabled (Form Field Enabled)

§2.16.14

entryMacro (Script Function to Execute on Form Field Entry)

§2.16.15

exitMacro (Script Function to Execute on Form Field Exit)

§2.16.16

helpText (Associated Help Text)

§2.16.23

name (Form Field Name)

§2.16.28

statusText (Associated Status Text)

§2.16.32

textInput (Text Box Form Field Properties)

§2.16.33

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

<complexType name="CT_FFData">

   <choice maxOccurs="unbounded">

   <element name="name" type="CT_FFName"/>

   <element name="enabled" type="CT_OnOff"/>

   <element name="calcOnExit" type="CT_OnOff"/>

   <element name="entryMacro" type="CT_MacroName" minOccurs="0" maxOccurs="1"/>

   <element name="exitMacro" type="CT_MacroName" minOccurs="0" maxOccurs="1"/>

   <element name="helpText" type="CT_FFHelpText" minOccurs="0" maxOccurs="1"/>

   <element name="statusText" type="CT_FFStatusText" minOccurs="0" maxOccurs="1"/>

   <choice>

   <element name="checkBox" type="CT_FFCheckBox"/>

   <element name="ddList" type="CT_FFDDList"/>

   <element name="textInput" type="CT_FFTextInput"/>

   </choice>

   </choice>

</complexType>