|
<< Click to Display Table of Contents >> ListEntry (Objekt) |
Zugriffspfade:
▪Application à Documents à Item à FormFields à Item à DropDown à ListEntries à Item
▪Application à ActiveDocument à FormFields à Item à DropDown à ListEntries à Item
1 Beschreibung
Ein ListEntry-Objekt repräsentiert einen einzelnen Eintrag in einer Auswahlliste (einem Formularobjekt) und erlaubt es Ihnen, diesen auszulesen, zu verändern und zu löschen.
Für jeden Eintrag in einer Auswahlliste existiert ein eigenes ListEntry-Objekt. Fügen Sie der Auswahlliste Einträge hinzu oder löschen diese, werden die zugehörigen ListEntry-Objekte dynamisch angelegt bzw. entfernt.
2 Zugriff auf das Objekt
Die einzelnen ListEntry-Objekte können ausschließlich durch Aufzählung der Elemente der ListEntries-Sammlung angesprochen werden. Von dieser Sammlung besitzt jede Auswahlliste genau eine Instanz.
Ein Beispiel:
' Aus dem 1. Formularfeld des Dokuments (einem Dropdown) einen Eintrag zeigen
MsgBox tm.ActiveDocument.FormFields(1).DropDown.ListEntries.Item(1).Name
3 Eigenschaften, Objekte, Sammlungen und Methoden
Eigenschaften:
▪Name (Defaulteigenschaft)
Objekte:
▪Application → Application
▪Parent → ListEntries
Methoden:
▪Delete
Name (Eigenschaft)
Datentyp: String
Liest oder setzt den Inhalt des ListEntry-Objekts – in anderen Worten: den Inhalt des jeweiligen Listeneintrags.
Beispiele:
' Den ersten Listeneintrag anzeigen
MsgBox tm.ActiveDocument.FormFields(1).DropDown.ListEntries.Item(1).Name
' Den ersten Listeneintrag auf einen neuen Wert setzen
tm.ActiveDocument.FormFields(1).DropDown.ListEntries.Item(1).Name = "Grün"
Hinweis: Sie können auf diese Weise nur den Text von bereits existierenden Listeneinträgen ersetzen. Wollen Sie hingegen der Liste neue Einträge hinzufügen, benutzen Sie dafür die Methode Add in der ListEntries-Sammlung.
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 ListEntries.
Delete (Methode)
Löscht das ListEntry-Objekt aus der übergeordneten ListEntries-Sammlung.
Syntax:
Delete
Parameter:
| keine |
Rückgabetyp:
| keiner |
Beispiel:
' Den ersten Listeneintrag löschen
tm.ActiveDocument.FormFields(1).DropDown.ListEntries.Item(1).Delete