ComboBox.ObjectCollection.Add(Object) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dodaje element do listy elementów dla elementu ComboBox.
public:
int Add(System::Object ^ item);
public int Add (object item);
member this.Add : obj -> int
Public Function Add (item As Object) As Integer
Parametry
- item
- Object
Obiekt reprezentujący element, który ma zostać dodany do kolekcji.
Zwraca
Indeks oparty na zerowym elemencie w kolekcji.
Wyjątki
Parametr item
to null
.
Uwagi
Ta metoda dodaje element do pola kombi.
Sorted Jeśli właściwość ComboBox jest ustawiona na true
, element zostanie wstawiony do listy alfabetycznie. W przeciwnym razie element zostanie wstawiony na końcu listy.
Wizualna reprezentacja elementu jest wyświetlana w polu kombi. Ta reprezentacja zawartości jest określana przez DisplayMember właściwość .
DisplayMember Jeśli właściwość to null
, metoda elementu ToString
jest wywoływana w celu uzyskania ciągu wyświetlanego w polu kombi. W przeciwnym razie właściwość przechowywanego obiektu określona przez DisplayMember właściwość jest wyświetlana. Występuje SystemException , jeśli za mało miejsca do przechowywania nowego elementu. Aby dodać zestaw elementów do pola kombi, najlepiej użyć AddRange metody . Jeśli zdecydujesz się użyć Add metody w celu dodania wielu elementów do pola kombi, użyj BeginUpdate metody , aby wstrzymać ponowne malowanie podczas dodawania i EndUpdate metodę w celu wznowienia ponownego malowania. Możesz użyć Insert metody , aby określić lokalizację na liście, w której jest dodawany element. Po dodaniu obiektu do kolekcji ComboBox obiekt wywołuje metodę obiektu ToString w celu uzyskania ciągu do wyświetlenia na liście.