Partager via


ComboBox.ObjectCollection.Add(Object) Méthode

Définition

Ajoute un élément à la liste des éléments d’un 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

Le item paramètre était null.

Remarques

Cette méthode ajoute un élément à la zone de liste déroulante. Si la Sorted propriété de l’élément ComboBox est définie truesur , 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 DisplayMember propriété est null, 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. Un SystemException événement se produit s’il n’y a pas suffisamment d’espace disponible 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 la BeginUpdate peinture pendant votre ajout et la EndUpdate méthode pour reprendre la peinture. 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, il ComboBox appelle la méthode de ToString l’objet pour obtenir la chaîne à afficher dans la liste.

S’applique à

Voir aussi