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

Parent Elements

<fldChar> (§2.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>