ListEntries Object (Word)

A collection of ListEntry objects that represent all the items in a drop-down form field.

Remarks

Use the ListEntries property to return the ListEntries collection. The following example displays the items that appear in the form field named "Drop1."

For Each le In _ 
 ActiveDocument.FormFields("Drop1").DropDown.ListEntries 
 MsgBox le.Name 
Next le

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

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

See also

Word Object Model Reference