ComboBox.AddItem-Methode (Access)

Artikel
04/07/2023

Fügt der Wertliste, die vom angegebenen Kombinationsfeld-Steuerelement angezeigt werden, ein neues Element hinzu.

Syntax

Ausdruck. AddItem (Item, Index)

Ausdruck Eine Variable, die ein ComboBox-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Item	Erforderlich	String	Der angezeigte Text für das neue Element.
Index	Optional	Variant	Die Position des Elements in der Liste. Wird dieses Argument nicht angegeben, wird das Element am Ende der Liste hinzugefügt.

Hinweise

Die RowSourceType-Eigenschaft des angegebenen Steuerelements muss auf Wertliste festgelegt werden.

Diese Methode ist nur für Listenfeld- oder Kombinationsfeld-Steuerelemente in Formularen zulässig.

Listenelementnummern beginnen mit 0. Wenn der Wert des Arguments Item nicht einer vorhandenen Elementnummer entspricht, tritt ein Fehler auf.

Verwenden Sie für mehrspaltige Listen Semikolons, um die Zeichenfolgen für die verschiedenen Spalten zu trennen (z. B. 1010;rot;groß für eine Liste mit drei Spalten). Falls das Argument Item weniger Zeichenfolgen als Spalten im Steuerelement aufweist, werden Elemente ausgehend von der Spalte ganz links hinzugefügt. Enthält das Argument Item mehr Zeichenfolgen als Spalten im Steuerelement, werden die zusätzlichen Zeichenfolgen ignoriert.

Verwenden Sie die Methode RemoveItem, um Elemente aus der Liste mit Werten zu entfernen.

Beispiel

In dem folgenden Beispiel wird ein Element am Ende der Liste in einem Listenfeld-Steuerelement hinzugefügt. Damit die Funktion funktionsfähig ist, müssen Sie ihr ein Objekt ListBox übergeben, das ein Listenfeld-Steuerelement in einem Formular repräsentiert, sowie einen String-Wert, der den Elementtext repräsentiert, der hinzugefügt werden soll.

Function AddItemToEnd(ctrlListBox As ListBox, _ 
 ByVal strItem As String) 
 
 ctrlListBox.AddItem Item:=strItem 
 
End Function

In dem folgenden Beispiel wird ein Element am Anfang der Liste in einem Kombinationsfeld-Steuerelement hinzugefügt. Damit die Funktion funktionsfähig ist, müssen Sie ihr ein Objekt ComboBox übergeben, das ein Kombinationsfeld-Steuerelement in einem Formular repräsentiert, sowie einen String-Wert, der den Elementtext repräsentiert, der hinzugefügt werden soll.

Function AddItemToBeginning(ctrlComboBox As ComboBox, _ 
 ByVal strItem As String) 
 
 ctrlComboBox.AddItem Item:=strItem, Index:=0 
 
End Function

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über