ComboBox.ObjectCollection.Add(Object) Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

Int32

Index de base zéro de l'élément dans la collection.

Exceptions

ArgumentNullException

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 nullla 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.

S’applique à

Voir aussi