Share via


Field Object

Word Developer Reference

Represents a field. The Field object is a member of the Fields collection. The Fields collection represents the fields in a selection, range, or document.

Remarks

Use Fields(Index), where Index is the index number, to return a single Field object. The index number represents the position of the field in the selection, range, or document. The following example displays the field code and the result of the first field in the active document.

Visual Basic for Applications
  If ActiveDocument.Fields.Count >= 1 Then
    MsgBox "Code =  " & ActiveDocument.Fields(1).Code & vbCr _
        & "Result =  " & ActiveDocument.Fields(1).Result & vbCr
End If

Use the Add method to add a field to the Fields collection. The following example inserts a DATE field at the beginning of the selection and then displays the result.

Visual Basic for Applications
  Selection.Collapse Direction:=wdCollapseStart
Set myField = ActiveDocument.Fields.Add(Range:=Selection.Range, _
    Type:=wdFieldDate)
MsgBox myField.Result
Bb211922.vs_note(en-us,office.12).gif  Note
The wdFieldDate constant is part of the WdFieldType group of constants, which includes all the various field types.

See Also