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

Entfernt ein Element aus der Wertliste, die vom angegebenen Listenfeld-Steuerelement angezeigt wird.Removes an item from the list of values displayed by the specified list box control.

SyntaxSyntax

Ausdruck. RemoveItem (Index)expression.RemoveItem (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
IndexIndex ErforderlichRequired VariantVariant Das aus der Liste zu entfernende Element, das als Elementnummer oder Listenelementtext angegeben ist.The item to be removed from the list, expressed as either an item number or the list item text.

HinweiseRemarks

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. Außerdem muss die **** Daten Satz herkunfttype-Eigenschaft des Steuerelements auf Werteliste festgelegt werden.Also, the RowSourceType property of the control must be set to Value List.

Listenelementnummern beginnen mit 0.List item numbers start from zero. Entspricht der Wert des Arguments Index keiner vorhandenen Elementnummer oder keinem Text eines vorhandenen Elements, tritt ein Fehler auf.If the value of the Index argument doesn't correspond to an existing item number or the text of an existing item, an error occurs.

Verwenden Sie die AddItem-Methode, um Elemente zur Wertliste hinzuzufügen.Use the AddItem method to add items to the list of values.

BeispielExample

Das folgende Beispiel entfernt das angegebene Element aus der Liste in einem Listenfeld-Steuerelement.This example removes the specified item from the list in a list box control. 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.For the function to work, you must pass it a ListBox object representing a list box control on a form and a Variant value representing the item to be removed.

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 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.