ComboBox.ObjectCollection.Add(Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt der Liste von Elementen für eine ComboBox ein Element hinzu.
public:
int Add(System::Object ^ item);public int Add (object item);member this.Add : obj -> intPublic Function Add (item As Object) As IntegerParameter
- item
- Object
Ein Objekt, das das der Auflistung hinzuzufügende Element darstellt.
Gibt zurück
Der nullbasierte Index des Elements in der Auflistung.
Ausnahmen
Der item-Parameter war null.
Hinweise
Diese Methode fügt dem Kombinationsfeld ein Element hinzu. Wenn die Sorted -Eigenschaft auf ComboBox festgelegt trueist, wird das Element alphabetisch in die Liste eingefügt. Andernfalls wird das Element am Ende der Liste eingefügt.
Im Kombinationsfeld wird eine visuelle Darstellung des Elements angezeigt. Diese Inhaltsdarstellung wird durch die DisplayMember -Eigenschaft angegeben. Wenn die DisplayMember -Eigenschaft lautet null, wird die Methode des ToString Elements aufgerufen, um die Zeichenfolge abzurufen, die im Kombinationsfeld angezeigt wird. Andernfalls wird die Eigenschaft des gespeicherten Objekts angezeigt, wie durch die DisplayMember -Eigenschaft angegeben. Ein SystemException tritt auf, wenn nicht genügend Speicherplatz zum Speichern des neuen Elements verfügbar ist. Um dem Kombinationsfeld einen Satz von Elementen hinzuzufügen, empfiehlt es sich, die AddRange -Methode zu verwenden. Wenn Sie die Add -Methode verwenden, um dem Kombinationsfeld eine Reihe von Elementen hinzuzufügen, verwenden Sie die -Methode, um die BeginUpdate Neulackierung während des Add-Vorgangs anzusetzen und die -Methode, um die EndUpdate Neulackierung fortzusetzen. Sie können die Insert -Methode verwenden, um den Speicherort in der Liste anzugeben, an dem ein Element hinzugefügt wird. Wenn der Auflistung ein Objekt hinzugefügt wird, ruft die ComboBox -Methode des ToString -Objekts auf, um die Zeichenfolge abzurufen, die in der Liste angezeigt werden soll.
