ListBox, contrôle

Le contrôle ListBox permet aux utilisateurs de sélectionner un ou plusieurs éléments dans une liste prédéfinie. Il diffère d’un contrôle DropDownList dans la mesure où il peut afficher plusieurs éléments à la fois et peut permettre à l’utilisateur d’en sélectionner plusieurs.

Pour ajouter un contrôle ListBox à une page

1. Faites glisser le contrôle ListBox du volet des tâches Boîte à outils sur votre page.

2. Définissez les propriétés du contrôle dans le volet des tâches Propriétés de la balise.

Propriétés courantes de ListBox

Propriété	Description
SelectionMode	Affectez la valeur Simple ou Multiple pour spécifier le nombre d’éléments que les utilisateurs peuvent sélectionner.
Lignes	Spécifie le nombre de lignes affichées. Vous pouvez définir le contrôle de telle façon qu’il affiche un nombre spécifique d’éléments. Si le contrôle contient plus d’éléments que prévu, il affiche une barre de défilement verticale.
Hauteur et largeur	Spécifie la taille du contrôle en pixels. Lorsque vous spécifiez une Hauteur et une Largeur, le contrôle ignore le nombre de lignes que vous avez défini et en affiche autant que sa hauteur lui permet d’en contenir. Certains navigateurs ne prennent pas en charge la définition de la hauteur et de la largeur en pixels et utilisent le nombre de lignes comme paramètre.

Pour une description complète de toutes les propriétés du contrôle ListBox, voir Propriétés ListBox dans MSDN Library.

Ajouter des éléments au contrôle ListBox

Avant qu’un contrôle ListBox puisse offrir à un utilisateur un choix de différents éléments, vous devez remplir le contrôle ListBox d’éléments. Vous pouvez le faire en liant le contrôle à une source de données ou en définissant individuellement des éléments pour le contrôle ListBox.

Pour lier le contrôle ListBox à une source de données

1. En mode Création, cliquez avec le bouton droit sur le contrôle ListBox, puis cliquez sur Afficher les tâchesde contrôle courantes.

2. Dans le menu Tâches courantes du contrôle DropDownList, cliquez sur Choisir une source de données.

3. Dans l’Assistant Configuration de source de données, choisissez une source pour le contrôle ListBox dans la liste déroulante Sélectionnez une source de données. Dans la liste déroulante Sélectionnez un champ de données à afficher dans ListBox, sélectionnez le champ pour le texte que l’utilisateur verra. Dans la liste déroulante Sélectionnezun champ de données pour la valeur de ListBox, sélectionnez le champ des données qui peut être accessible par programme lorsque l’utilisateur choisit un élément dans la liste.

Définir des éléments pour le contrôle ListBox

1. En mode Création, cliquez avec le bouton droit sur le contrôle ListBox, puis cliquez sur Afficher les tâchesde contrôle courantes.

2. Dans le menu Tâches courantes du contrôle DropDownList, cliquez sur Modifier les éléments.

3. Dans la boîte de dialogue Éditeur de collections ListItem, cliquez sur Ajouter pour ajouter un élément.

4. Dans la zone Propriétés ListItem, définissez les propriétés Texte et Valeur.

5. Répétez les étapes 3 à 4 jusqu’à ce que vous ayez ajouté tous les éléments souhaités.