Share via

DropDown Object

  • Article
Word Developer Reference

Represents a drop-down form field that contains a list of items in a form.

Remarks

Use FormFields(index), where index is the index number or the bookmark name associated with the drop-down form field, to return a single FormField object. Use the DropDown property with the FormField object to return a DropDown object. The following example selects the first item in the drop-down form field named "DropDown" in the active document.

Visual Basic for Applications 
  ActiveDocument.FormFields("DropDown1").DropDown.Value = 1

The index number represents the position of the form field in the FormFields collection. The following example checks the type of the first form field in the active document. If it is a drop-down form field, the second item is selected.

Visual Basic for Applications 
  If ActiveDocument.FormFields(1).Type = wdFieldFormDropDown Then
    ActiveDocument.FormFields(1).DropDown.Value = 2
End If

The following example determines whether form field represented by ffield is a valid drop-down form field before adding an item to it.

Visual Basic for Applications 
  Set ffield = ActiveDocument.FormFields(1).DropDown
If ffield.Valid = True Then 
    ffield.ListEntries.Add Name:="Hello"
Else
    MsgBox "First field is not a drop down"
End If

Use the Add method with the FormFields collection to add a drop-down form field. The following example adds a drop-down form field at the beginning of the active document and then adds items to the form field.

Visual Basic for Applications 
  Set ffield = ActiveDocument.FormFields.Add( _
    Range:=ActiveDocument.Range(Start:=0, End:=0), _
    Type:=wdFieldFormDropDown)
With ffield
    .Name = "Colors"
    With .DropDown.ListEntries
        .Add Name:="Blue"
        .Add Name:="Green"
        .Add Name:="Red"
    End With
End With

See Also