<< Click to Display Table of Contents >> ListEntries (Sammlung)

Zugriffspfade:

▪Application à Documents à Item à FormFields à Item à DropDown à ListEntries

▪Application à ActiveDocument à FormFields à Item à DropDown à ListEntries

 1  Beschreibung

ListEntries ist eine Sammlung aller Listeneinträge eines DropDown-Objekts. Hiermit können Sie die einzelnen Einträge einer Auswahlliste ansehen und bearbeiten.

Die einzelnen Elemente dieser Sammlung sind vom Typ ListEntry.

 2  Zugriff auf die Sammlung

Jedes DropDown-Formularobjekt besitzt genau eine Instanz der ListEntries-Sammlung. Diese wird über DropDown.ListEntries angesprochen:

' Anzahl der Listeneinträge des ersten Formularelements anzeigen

' (sofern es sich tatsächlich um eine Auswahlliste handelt)

 

If tm.ActiveDocument.FormFields(1).DropDown.Valid Then

 MsgBox tm.ActiveDocument.FormFields(1).DropDown.ListEntries.Count

End If

 3  Eigenschaften, Objekte, Sammlungen und Methoden

Eigenschaften:

▪Count R/O

 

Objekte:

▪Item → ListEntry (Defaultobjekt)

▪Application → Application

▪Parent → DropDown

 

Methoden:

▪Add

▪Clear

Count (Eigenschaft, R/O)

Datentyp: Long

Liefert die Anzahl der ListEntry-Objekte in der Sammlung – in anderen Worten: die Anzahl der Einträge in der Auswahlliste.

Item (Zeiger auf Objekt)

Datentyp: Object

Liefert ein einzelnes ListEntry-Objekt, also einen einzelnen Listeneintrag in der Auswahlliste.

Welches ListEntry-Objekt Sie erhalten, hängt von dem Parameter ab, den Sie an Item übergeben. Dies kann entweder der numerische Index oder der Name des gewünschten Listeneintrags sein. Beispiele:

' Den ersten Listeneintrag anzeigen

MsgBox tm.FormFields(1).DropDown.ListEntries.Item(1).Name

 

' Den Listeneintrag mit dem Text "Test" anzeigen

MsgBox tm.FormFields(1).DropDown.ListEntries.Item("Test").Name

Application (Zeiger auf Objekt)

Datentyp: Object

Liefert das Application-Objekt.

Parent (Zeiger auf Objekt)

Datentyp: Object

Liefert das übergeordnete Objekt, also ein Objekt vom Typ DropDown.

Add (Methode)

Fügt der Auswahlliste einen weiteren Eintrag hinzu.

Syntax:

 Add Name

Parameter:

Rückgabetyp:

Beispiel:

' Dem 1. Formularfeld des Dokuments (einem Dropdown) einen Eintrag hinzufügen

tm.ActiveDocument.FormFields(1).DropDown.ListEntries.Add "Grün"

 

' Dito, aber mit Nutzung des Rückgabewerts (Klammern beachten!)

Dim entry as Object

Set entry = tm.ActiveDocument.FormFields(1).DropDown.ListEntries.Add("Grün")

Clear (Methode)

Entfernt alle Einträge aus der Auswahlliste.

Syntax:

 Clear

Parameter:

Rückgabetyp:

Beispiel:

' Aus dem ersten Formularfeld des Dokuments alle Einträge entfernen

tm.ActiveDocument.FormFields(1).DropDown.ListEntries.Clear