Freigeben über

AddListItem-Methode

  • Artikel

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

Control.AddListItem(cItem [, nItemID] [, nColumn])

Parameter

  • cItem
    Gibt das Element an, das dem Steuerelement hinzugefügt werden soll.

  • nItemID
    Gibt eine Ganzzahl an, welche die eindeutige ID des Steuerelementeintrags darstellt. Der maximale Wert, den Sie für nItemID angeben können, ist 32.767.

    Wenn Sie nItemID nicht angeben und die Sorted-Eigenschaft auf Wahr (.T.) gesetzt ist, wird cItem entsprechend der alphabetischen Sortierreihenfolge eingefügt. Wenn Sie nItemID nicht angeben und die Sorted-Eigenschaft auf Falsch (.F.) gesetzt 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, in die das neue Element eingefü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

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

Betrifft: Kombinationsfeld-Steuerelement (ComboBox) | Listenfeld-Steuerelement (ListBox)