FormFields Collection Object

Microsoft Word Visual Basic

FormFields Collection Object

         
Multiple objects FormFields (FormField)
Multiple objects

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

Using the FormFields Collection

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

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.

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."

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.

If Selection.FormFields.Count >= 1 Then
    MsgBox Selection.FormFields(1).Name
End If