Freigeben über

AddItem-Methode

  • Artikel

Fügt einem Kombinationsfeld-Steuerelement (ComboBox) oder einem Listenfeld-Steuerelement (ListBox) ein neues Element hinzu und ermöglicht Ihnen optional, den Index des Elements anzugeben.

Control.AddItem(cItem [, nIndex] [, nColumn])

Parameter

  • cItem
    Gibt den Zeichenfolgenausdruck an, der dem Steuerelement hinzugefügt werden soll.

  • nIndex
    Gibt die Position an, an der das Element eingefügt werden soll. Wenn Sie für das optionale Argument nIndex einen gültigen Wert liefern, wird cItem an dieser Position im Steuerelement angeordnet. Wenn Sie für nIndex einen bereits vorhandenen Wert angeben, wird das Element an dieser Stelle eingefügt, und alle folgenden Elemente werden im Listenteil des Kombinationsfeld-Steuerelements (ComboBox) oder Listenfeld-Steuerelements (ListBox) um eine Position nach unten verschoben.

    Wenn Sie nIndex nicht angeben und die Sorted-Eigenschaft auf Wahr (.T.) festgelegt ist, wird cItem entsprechend der alphabetischen Sortierreihenfolge eingefügt. Wenn Sie nIndex nicht angeben und die Sorted-Eigenschaft auf Falsch (.F.) festgelegt ist, wird cItem am Ende des Listenteils des Kombinationsfeld-Steuerelements (ComboBox) oder des Listenfeld-Steuerelements (ListBox) eingefügt.

  • nColumn
    Gibt die Spalte des Steuerelements an, zu der das neue Element hinzugefügt werden soll. Der Standardwert beträgt 1.

Hinweise

Verwenden Sie die AddItem- oder AddListItem-Methode, wenn die RowSourceType-Eigenschaft auf 0 (Keine) festgelegt ist.

Jedem Eintrag, der zu einem Kombinationsfeld-Steuerelement (ComboBox) oder Listenfeld-Steuerelement (ListBox) hinzugefügt wird, werden zwei Kennungen zugewiesen:

  • nItemID, eine ganze Zahl, die der eindeutigen ID-Nummer des Elements im Steuerelement entspricht. Das erste gespeicherte Element entspricht nItemID = 1, es sei denn, für nItemID wird ein anderer Wert angegeben.
  • nIndex, eine ganze Zahl, die der Reihenfolge entspricht, in der die Elemente im Steuerelement angezeigt werden. Das erste Element im Steuerelement entspricht nIndex = 1.

Siehe auch

AddListItem-Methode | Clear-Methode | ListIndex-Eigenschaft | ListItemID-Eigenschaft | RowSourceType-Eigenschaft | RemoveItem-Methode | Sorted-Eigenschaft