Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListBox.ObjectCollection.Add méthode (Object)

 

Date de publication : novembre 2016

Ajoute un élément à la liste des éléments pour un ListBox.

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

public int Add(
	object item
)

Paramètres

item
Type: System.Object

Objet représentant l’élément à ajouter à la collection.

Valeur de retour

Type: System.Int32

Index de base zéro de l’élément dans la collection, ou -1 si BeginUpdate a été appelée.

Exception Condition
SystemException

Il espace disponible est insuffisant pour ajouter le nouvel élément à la liste.

ArgumentNullException

item a la valeur null.

Si le Sorted propriété de la ListBox 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. Pour insérer un élément dans la zone de liste à une position spécifique, utilisez la Insert méthode. Pour ajouter un ensemble d’éléments à la zone de liste en une seule opération, utilisez la AddRange méthode. Si vous souhaitez utiliser le Add méthode pour ajouter un grand nombre d’éléments à la liste, utilisez le BeginUpdate et EndUpdate méthodes afin d’éviter le ListBox à partir de la mise à jour chaque fois qu’un élément est ajouté à la liste jusqu'à ce que tous les éléments sont ajoutés à la liste. Lorsque vous ajoutez des éléments à un ListBox, il est plus efficace de trier les éléments tout d’abord, puis ajouter de nouveaux éléments.

Lorsqu’un objet est ajouté à la collection, le ListBox vérifie d’abord afin de déterminer si le DisplayMember propriété de la ListControl classe porte le nom d’un membre de l’objet spécifié à référencer lors de l’obtention du texte de l’élément. Si le DisplayMember propriété n’a pas d’un membre spécifié, le ListBox appelle ensuite la ToString méthode de l’objet pour obtenir le texte à afficher dans la liste.

L’exemple de code suivant montre comment créer un ListBox contrôle qui affiche plusieurs éléments dans des colonnes et peut avoir plus d’un élément sélectionné dans la liste de contrôle. Le code de l’exemple ajoute 50 éléments à la ListBox à l’aide de la Add méthode de la ListBox.ObjectCollection (classe), puis sélectionne trois éléments dans la liste à l’aide la SetSelected (méthode). Le code affiche ensuite les valeurs de la ListBox.SelectedObjectCollection collection (via le SelectedItems propriété) et ListBox.SelectedIndexCollection (via le SelectedIndices propriété). Cet exemple requiert que le code se trouve dans et appelé à partir d’un Form.

private void button1_Click(object sender, System.EventArgs e)
{
   // Create an instance of the ListBox.
   ListBox listBox1 = new ListBox();
   // Set the size and location of the ListBox.
   listBox1.Size = new System.Drawing.Size(200, 100);
   listBox1.Location = new System.Drawing.Point(10,10);
   // Add the ListBox to the form.
   this.Controls.Add(listBox1);
   // Set the ListBox to display items in multiple columns.
   listBox1.MultiColumn = true;
   // Set the selection mode to multiple and extended.
   listBox1.SelectionMode = SelectionMode.MultiExtended;

   // Shutdown the painting of the ListBox as items are added.
   listBox1.BeginUpdate();
   // Loop through and add 50 items to the ListBox.
   for (int x = 1; x <= 50; x++)
   {
      listBox1.Items.Add("Item " + x.ToString());
   }
   // Allow the ListBox to repaint and display the new items.
   listBox1.EndUpdate();

   // Select three items from the ListBox.
   listBox1.SetSelected(1, true);
   listBox1.SetSelected(3, true);
   listBox1.SetSelected(5, true);

   // Display the second selected item in the ListBox to the console.
   System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems[1].ToString());
   // Display the index of the first selected item in the ListBox.
   System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices[0].ToString());             
}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: