Share via

FormFields Collection Object

  • Article
Word Developer Reference

A collection of FormField objects that represent all the form fields in a selection, range, or document.

Remarks

Use the FormFields property to return the FormFields collection. The following example counts the number of text box form fields in the active document.

Visual Basic for Applications 
  For Each aField In ActiveDocument.FormFields
    If aField.Type = wdFieldFormTextInput Then count = count + 1
Next aField
MsgBox "There are " & count & " text boxes in this document"

Use the Add method with the FormFields object to add a form field. The following example adds a check box at the beginning of the active document and then selects the check box.

Visual Basic for Applications 
  Set ffield = ActiveDocument.FormFields.Add( _
    Range:=ActiveDocument.Range(Start:=0,End:=0), _
    Type:=wdFieldFormCheckBox)
ffield.CheckBox.Value = True

Use FormFields(Index), where Index is a bookmark name or index number, to return a single FormField object. The following example sets the result of the Text1 form field to "Don Funk."

Visual Basic for Applications 
  ActiveDocument.FormFields("Text1").Result = "Don Funk"

The index number represents the position of the form field in the selection, range, or document. The following example displays the name of the first form field in the selection.

Visual Basic for Applications 
  If Selection.FormFields.Count >= 1 Then
    MsgBox Selection.FormFields(1).Name
End If

See Also