Partager via


Vue d'ensemble du contrôle ListBox (Windows Forms)

Un contrôle ListBox Windows Forms affiche une liste d'éléments dans laquelle l'utilisateur peut effectuer un ou plusieurs choix. Si le nombre total d'éléments excède la capacité d'affichage, une barre de défilement est automatiquement ajoutée au contrôle ListBox. Lorsque la propriété MultiColumn a la valeur true, la zone de liste affiche des éléments dans plusieurs colonnes et une barre de défilement horizontale s'affiche. Lorsque la propriété MultiColumn a la valeur false, la zone de liste affiche des éléments dans une seule colonne et une barre de défilement verticale s'affiche. Lorsque la propriété ScrollAlwaysVisible a la valeur true, la barre de défilement s'affiche, quel que soit le nombre d'éléments. La propriété SelectionMode détermine le nombre d'éléments pouvant être sélectionnés en même temps.

Modes de modification du contrôle ListBox

La propriété SelectedIndex retourne une valeur entière correspondant au premier élément sélectionné dans la zone de liste. Vous pouvez modifier par programme l'élément sélectionné en changeant la valeur de la propriété SelectedIndex dans le code ; l'élément de liste correspondant est affiché en surbrillance dans le Windows Form. Si aucun élément n'est sélectionné, la valeur de SelectedIndex est -1. Si le premier élément dans la liste est sélectionné, la valeur SelectedIndex est 0. Lorsque plusieurs éléments sont sélectionnées, la valeur SelectedIndex reflète l'élément sélectionné qui s'affiche en premier dans la liste. La propriété SelectedItem est similaire à la propriété SelectedIndex, à cela près qu'elle retourne l'élément lui-même, en général une valeur de chaîne. La propriété Count indique le nombre d'éléments contenus dans la liste et la valeur de la propriété Count est toujours supérieure d'une unité à celle de la plus haute valeur de SelectedIndex, car la propriété SelectedIndex est numérotée à partir de zéro.

Pour ajouter ou supprimer des éléments dans un contrôle ListBox, utilisez la méthode Add, Insert, Clear ou Remove. Au moment du design, vous pouvez également ajouter des éléments à la liste en utilisant la propriété Items.

Voir aussi

Tâches

Comment : ajouter et supprimer des éléments d'un contrôle ComboBox, ListBox ou CheckedListBox Windows Forms

Comment : trier le contenu d'un contrôle ComboBox, CheckedListBox ou ListBox Windows Forms

Comment : lier un contrôle ComboBox ou ListBox Windows Forms aux données

Comment : créer une table de correspondance pour un contrôle ComboBox, ListBox ou CheckedListBox Windows Forms

Référence

Vue d'ensemble du contrôle ComboBox (Windows Forms)

Vue d'ensemble du contrôle CheckedListBox (Windows Forms)

ListBox

Autres ressources

Contrôles Windows Forms utilisés pour l'affichage de listes d'options