ComboBox.ObjectCollection.Add(Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un élément à la liste d'éléments pour 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
Paramètres
- item
- Object
Objet représentant l'élément à ajouter à la collection.
Retours
Index de base zéro de l'élément dans la collection.
Exceptions
La valeur du paramètre item
était null
.
Remarques
Cette méthode ajoute un élément à la zone de liste déroulante. Si la Sorted propriété du ComboBox est définie sur true
, l’élément est inséré dans la liste par ordre alphabétique. Sinon, l’élément est inséré à la fin de la liste.
Une représentation visuelle de l’élément s’affiche dans la zone de liste déroulante. Cette représentation de contenu est spécifiée par la DisplayMember propriété . Si la propriété a null
la DisplayMember valeur , la méthode de ToString
l’élément est appelée pour obtenir la chaîne affichée dans la zone de liste déroulante ; sinon, la propriété de l’objet stocké tel que spécifié par la DisplayMember propriété s’affiche. Une SystemException erreur se produit si l’espace disponible est insuffisant pour stocker le nouvel élément. Pour ajouter un ensemble d’éléments à la zone de liste déroulante, il est préférable d’utiliser la AddRange méthode . Si vous choisissez d’utiliser la Add méthode pour ajouter un certain nombre d’éléments à la zone de liste déroulante, utilisez la méthode pour suspendre le BeginUpdate repeint pendant votre ajout et la méthode pour reprendre le EndUpdate repeint. Vous pouvez utiliser la Insert méthode pour spécifier l’emplacement dans la liste où un élément est ajouté. Lorsqu’un objet est ajouté à la collection, le ComboBox appelle la méthode de ToString l’objet pour obtenir la chaîne à afficher dans la liste.