ListBox.RemoveItem-Methode (Access)

Entfernt ein Element aus der Wertliste, die vom angegebenen Listenfeld-Steuerelement angezeigt wird.

Syntax

Ausdruck. RemoveItem (Index)

Ausdruck Eine Variable, die ein ListBox- -Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Index	Erforderlich	Variant	Das aus der Liste zu entfernende Element, das als Elementnummer oder Listenelementtext angegeben ist.

Hinweise

Diese Methode ist nur für Listenfeld- oder Kombinationsfeld-Steuerelemente in Formularen zulässig. Außerdem muss die RowSourceType-Eigenschaft des Steuerelements auf Wertliste festgelegt werden.

Listenelementnummern beginnen mit 0. Entspricht der Wert des Arguments Index keiner vorhandenen Elementnummer oder keinem Text eines vorhandenen Elements, tritt ein Fehler auf.

Verwenden Sie die AddItem-Methode, um Elemente zur Wertliste hinzuzufügen.

Beispiel

Das folgende Beispiel entfernt das angegebene Element aus der Liste in einem Listenfeld-Steuerelement. Damit die Funktion funktionsfähig ist, müssen Sie ihr ein ListBox-Objekt übergeben, das ein Listenfeld-Steuerelement in einem Formular repräsentiert, sowie einen Variant-Wert, der das zu entfernende Element repräsentiert.

Function RemoveListItem(ctrlListBox As ListBox, _ 
 ByVal varItem As Variant) As Boolean 
 
 ' Trap for errors. 
 On Error GoTo ERROR_HANDLER 
 
 ' Remove the list box item and set the return value 
 ' to True, indicating success. 
 ctrlListBox.RemoveItem Index:=varItem 
 RemoveListItem = True 
 
 ' Reset the error trap and exit the function. 
 On Error GoTo 0 
 Exit Function 
 
' Return False if an error occurs. 
ERROR_HANDLER: 
 RemoveListItem = False 
 
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.