ListBox. AddItem-Methode (Access)ListBox.AddItem method (Access)

Fügt der Liste der Werte, die vom angegebenen Listenfeld-Steuerelement angezeigt werden, ein neues Element hinzu.Adds a new item to the list of values displayed by the specified list box control.

SyntaxSyntax

Ausdruck. AddItem (Item, Index)expression.AddItem (Item, Index)

Ausdruck Eine Variable, die ein ListBox -Objekt darstellt.expression A variable that represents a ListBox object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
ItemItem ErforderlichRequired StringString Der angezeigte Text für das neue Element.The display text for the new item.
IndexIndex OptionalOptional VariantVariant Die Position des Elements in der Liste.The position of the item in the list. Wird dieses Argument nicht angegeben, wird das Element am Ende der Liste hinzugefügt.If this argument is omitted, the item is added to the end of the list.

BemerkungenRemarks

Die **** Daten Satz herkunfttype-Eigenschaft des angegebenen Steuerelements muss auf Wertliste festgelegt werden.The RowSourceType property of the specified control must be set to Value List.

Diese Methode ist nur für Listenfeld- oder Kombinationsfeld-Steuerelemente in Formularen zulässig.This method is only valid for list box or combo box controls on forms.

Listenelementnummern beginnen mit 0.List item numbers start from zero. Wenn der Wert des Arguments Item nicht einer vorhandenen Elementnummer entspricht, tritt ein Fehler auf.If the value of the Item argument doesn't correspond to an existing item number, an error occurs.

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).For multiple-column lists, use semicolons to delimit the strings for each column (for example, "1010;red;large" for a three-column list). Falls das Argument Item weniger Zeichenfolgen als Spalten im Steuerelement aufweist, werden Elemente ausgehend von der Spalte ganz links hinzugefügt.If the Item argument contains fewer strings than columns in the control, items will be added starting with the left-most column. Enthält das Argument Item mehr Zeichenfolgen als Spalten im Steuerelement, werden die zusätzlichen Zeichenfolgen ignoriert.If the Item argument contains more strings than columns in the control, the extra strings are ignored.

Verwenden Sie die Methode RemoveItem, um Elemente aus der Liste mit Werten zu entfernen.Use the RemoveItem method to remove items from the list of values.

BeispielExample

In dem folgenden Beispiel wird ein Element am Ende der Liste in einem Listenfeld-Steuerelement hinzugefügt.This example adds an item to the end of the list in a list box control. 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.For the function to work, you must pass it a ListBox object representing a list box control on a form and a String value representing the text of the item to be added.

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.This example adds an item to the beginning of the list in a combo box control. 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.For the function to work, you must pass it a ComboBox object representing a combo box control on a form and a String value representing the text of the item to be added.

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

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.