Fügt der Liste in einem einspaltigen Listenfeld-Steuerelement (ListBox) oder Kombinationsfeld-Steuerelement (ComboBox) ein Element hinzu. In einem mehrspaltigen Listenfeld- oder Kombinationsfeld-Steuerelement werden der Liste dagegen Zeilen hinzugefügt.
Syntax
Variant = object.AddItem [ item [, varIndex]]
Die Syntax für die AddItem-Methode besteht aus folgenden Teilen:
| Teil | Beschreibung |
|---|---|
| object | Erforderlich. Ein gültiges Objekt. |
| Item | Optional. Gibt das hinzuzufügende Element oder die hinzuzufügende Zeile an. Die Nummer des ersten Elements oder der ersten Zeile ist 0, die Nummer des zweiten Elements oder der zweiten Zeile ist 1 usw. |
| varIndex | Optional. Eine ganze Zahl, die die Position innerhalb des Objekts angibt, an der das neue Element oder die neue Zeile positioniert wird. |
Hinweise
Wenn Sie einen gültigen Wert für varIndex angeben, positioniert die AddItem-Methode das Element oder die Zeile an dieser Position innerhalb der Liste. Wenn Sie varIndex nicht angeben, fügt die Methode das Element oder die Zeile am Ende der Liste an.
Der Wert für varIndex darf nicht größer als der Wert der ListCount-Eigenschaft sein.
In einem mehrspaltigen Listenfeld-Steuerelement oder Kombinationsfeld-Steuerelement fügt die AddItem-Eigenschaft eine ganze Zeile hinzu, d.h., jeder Spalte des Steuerelements wird ein Element hinzugefügt. Verwenden Sie die List- oder Column-Eigenschaft, und geben Sie außerdem die Zeile und Spalte des Elements an, wenn Sie einem Element einen Wert zuweisen wollen, das sich in einer anderen als der ersten Spalte befindet.
Wenn das Steuerelement an Daten gebunden ist, schlägt die AddItem-Methode fehl.
Anmerkung Sie können einem Kombinationsfeld- oder Listenfeld-Steuerelement mehrere Zeilen gleichzeitig hinzufügen, wenn Sie die List-Eigenschaft verwenden.