Vue d'ensemble du contrôle ListBox (Windows Forms)
Mise à jour : novembre 2007
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 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és, la valeur SelectedIndex reflète l'élément sélectionné qui apparaît 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 : 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
Référence
Vue d'ensemble du contrôle ComboBox (Windows Forms)
Vue d'ensemble du contrôle CheckedListBox (Windows Forms)
Autres ressources
Contrôles Windows Forms utilisés pour l'affichage de listes d'options