ComboBox.ObjectCollection.Add(Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Voegt een item toe aan de lijst met items voor een ComboBox.
public:
int Add(System::Object ^ item);public int Add(object item);member this.Add : obj -> intPublic Function Add (item As Object) As IntegerParameters
- item
- Object
Een object dat het item vertegenwoordigt dat moet worden toegevoegd aan de verzameling.
Retouren
De op nul gebaseerde index van het item in de verzameling.
Uitzonderingen
De item parameter was null.
Opmerkingen
Met deze methode wordt een item toegevoegd aan de keuzelijst met invoervak. Als de eigenschap van de SortedComboBox eigenschap is ingesteld op true, wordt het item alfabetisch in de lijst ingevoegd. Anders wordt het item aan het einde van de lijst ingevoegd.
Er wordt een visuele weergave van het item weergegeven in de keuzelijst met invoervak. Deze inhoudsweergave wordt opgegeven door de DisplayMember eigenschap. Als de DisplayMember eigenschap is null, wordt de methode van ToString het item aangeroepen om de tekenreeks te verkrijgen die wordt weergegeven in de keuzelijst met invoervak. Anders wordt de eigenschap van het opgeslagen object weergegeven zoals opgegeven door de DisplayMember eigenschap. Er SystemException treedt een op als er onvoldoende ruimte beschikbaar is om het nieuwe item op te slaan. Als u een set items wilt toevoegen aan de keuzelijst met invoervak, kunt u de AddRange methode het beste gebruiken. Als u ervoor kiest om de Add methode te gebruiken om een aantal items toe te voegen aan de keuzelijst met invoervak, gebruikt u de BeginUpdate methode om het opnieuw verven tijdens de invoegtoepassing te onderbreken en de EndUpdate methode om het opnieuw indelen te hervatten. U kunt de Insert methode gebruiken om de locatie op te geven in de lijst waarin een item wordt toegevoegd. Wanneer een object wordt toegevoegd aan de verzameling, roept de ComboBox methode van ToString het object aan om de tekenreeks te verkrijgen die in de lijst moet worden weergegeven.