FormFieldData class

Office 2013 and later

Form Field Properties. When the object is serialized out as xml, its qualified name is w:ffData.

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

public class FormFieldData : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

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 can 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 non-conformant.

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:name w:val="TextTextBox" />
    <w:enabled w:val="false"/>
      <w:maxLength w:val="10" />

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 (§17.16.27), a disabled state via the enabled element (§17.16.14), and a maximum character length of 10 characters via the maxLength element (§17.16.26). end example]

Parent Elements

fldChar (§17.16.18)

Child Elements


calcOnExit (Recalculate Fields When Current Field Is Modified)


checkBox (Checkbox Form Field Properties)


ddList (Drop-Down List Form Field Properties)


enabled (Form Field Enabled)


entryMacro (Script Function to Execute on Form Field Entry)


exitMacro (Script Function to Execute on Form Field Exit)


helpText (Associated Help Text)


label (Form Field Label)


name (Form Field Name)


statusText (Associated Status Text)


tabIndex (Form Field Navigation Order Index)


textInput (Text Box Form Field Properties)


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

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.