ListBox.SelectionMode Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
public:
property SelectionMode SelectionMode { SelectionMode get(); void set(SelectionMode value); };SelectionMode SelectionMode();
void SelectionMode(SelectionMode value);public SelectionMode SelectionMode { get; set; }var selectionMode = listBox.selectionMode;
listBox.selectionMode = selectionMode;Public Property SelectionMode As SelectionMode<ListBox SelectionMode="selectionModeValue"/>
Valeur de propriété
Une des valeurs SelectionMode .
Remarques
Par défaut, un utilisateur peut sélectionner un seul élément dans un ListBox. Vous pouvez définir la propriété ListBox.SelectionMode sur une valeur d’énumération SelectionMode pour activer la multi-sélection. Voici les valeurs du mode de sélection.
| Mode de sélection | Comportement |
|---|---|
| Unique | Un utilisateur peut sélectionner un seul élément à l’aide de la barre d’espace, du clic de souris ou de l’appui tactile. Un utilisateur peut désélectionner un élément à l’aide d’un mouvement de balayage vers le bas. - Tout en appuyant sur Ctrl : un utilisateur peut désélectionner l’élément à l’aide de la barre d’espace, d’un clic de souris ou d’un appui tactile. À l’aide des touches de direction, un utilisateur peut déplacer le focus indépendamment de la sélection. |
| Multiple | Un utilisateur peut sélectionner plusieurs éléments à l’aide de la barre d’espace, du clic de souris ou de l’appui tactile pour activer/désactiver la sélection sur l’élément sélectionné. À l’aide des touches de direction, un utilisateur peut déplacer le focus indépendamment de la sélection. |
| Étendu | Sans touches de modification : le comportement est identique à la sélection unique . - Tout en appuyant sur Ctrl : un utilisateur peut sélectionner plusieurs éléments à l’aide de la barre d’espace, d’un clic de souris ou d’un appui tactile pour désactiver la sélection sur l’élément ciblé. À l’aide des touches de direction, un utilisateur peut déplacer le focus indépendamment de la sélection. - Tout en appuyant sur Maj : un utilisateur peut sélectionner plusieurs éléments contigus en cliquant ou appuyant sur le premier élément de la sélection, puis sur le dernier élément de la sélection. À l’aide des touches de direction, un utilisateur peut créer une sélection contiguë à partir de l’élément sélectionné lorsque la touche MAJ est enfoncée. |
Lorsque SelectionMode est Unique, utilisez la propriété Selector.SelectedItem pour obtenir l’élément sélectionné. Lorsque SelectionMode est Multiple ou Étendu, utilisez la propriété SelectedItems pour obtenir les éléments sélectionnés.