Field Object

Description

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.

Using the Field Object

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.

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.

Selection.Collapse Direction:=wdCollapseStart
Set myField = ActiveDocument.Fields.Add(Range:=Selection.Range, _
    Type:=wdFieldDate)
MsgBox myField.Result

The wdFieldDate constant is part of the WdFieldType group of constants, which includes all the various field types.

Properties

Application property, Code property, Creator property, Data property, Index property, InlineShape property, Kind property, LinkFormat property, Locked property, Next property, OLEFormat property, Parent property, Previous property, Result property, ShowCodes property, Type property.

Methods

Copy method, Cut method, Delete method, DoClick method, Select method, Unlink method, Update method, UpdateSource method.