ListEntry Object

Microsoft Word Visual Basic

ListEntry Object

         
FormFields (FormField) DropDown
ListEntries (ListEntry)

Represents an item in a drop-down form field. The ListEntry object is a member of the ListEntries collection. The ListEntries collection includes all the items in a drop-down form field.

Using the ListEntry Object

Use ListEntries(index), where index is the list entry name or the index number, to return a single ListEntry object. The index number represents the position of the entry in the drop-down form field (the first item is index number 1). The following example deletes the "Blue" entry from the drop-down form field named "Color."

ActiveDocument.FormFields("Color").DropDown _
    .ListEntries("Blue").Delete

The following example displays the first item in the drop-down form field named "Color."

MsgBox _
    ActiveDocument.FormFields("Color").DropDown.ListEntries(1).Name

Use the Add method to add an item to a drop-down form field. The following example inserts a drop-down form field and then adds "red," "blue," and "green" to the form field.

Set myField = _
    ActiveDocument.FormFields.Add(Range:=Selection.Range, _
    Type:=wdFieldFormDropDown)
With myField.DropDown.ListEntries
    .Add Name:="Red"
    .Add Name:="Blue"
    .Add Name:="Green"
End With