ListViewBase.SelectionMode Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit le comportement de sélection d’un instance ListViewBase.

public:
 property ListViewSelectionMode SelectionMode { ListViewSelectionMode get(); void set(ListViewSelectionMode value); };

ListViewSelectionMode SelectionMode();

void SelectionMode(ListViewSelectionMode value);

public ListViewSelectionMode SelectionMode { get; set; }

var listViewSelectionMode = listViewBase.selectionMode;
listViewBase.selectionMode = listViewSelectionMode;

Public Property SelectionMode As ListViewSelectionMode

<listViewBase SelectionMode="listViewSelectionModeMemberName" />

Valeur de propriété

ListViewSelectionMode

Une des valeurs d’énumération ListViewSelectionMode . La valeur par défaut est Sélection unique .

Remarques

Par défaut, un utilisateur peut sélectionner un seul élément dans une vue. Vous pouvez définir la propriété SelectionMode sur une valeur d’énumération ListViewSelectionMode pour activer la sélection multiple ou désactiver la sélection. Voici les valeurs du mode de sélection.

Aucun	La sélection de l’élément est désactivée.
Unique	Sans touches de modification : 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	Sans touches de modification : 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 à celui de la sélection Simple. Tout en appuyant sur Ctrl : 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. Lorsque vous appuyez sur Maj : Un utilisateur peut sélectionner plusieurs éléments contigus en cliquant ou en appuyant sur le premier élément de la sélection, puis sur le dernier. À 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.

Notes

Les interactions tactiles sont activées uniquement lorsque IsSwipeEnabled a la valeur true.

Si SelectionMode a la valeur None et Que CanDragItems et CanReorderItems ont la valeur false, vous devez définir IsSwipeEnabled sur false pour améliorer les performances de l’application. Pour plus d’informations, consultez la propriété IsSwipeEnabled .

Lorsque SelectionMode a la valeur Single, utilisez la propriété Selector.SelectedItem pour obtenir l’élément sélectionné. Lorsque SelectionMode a la valeur Multiple ou Extended, utilisez la propriété SelectedItems pour obtenir les éléments sélectionnés.

Lorsque la sélection d’élément est désactivée, vous pouvez faire en sorte que les éléments répondent à un utilisateur en cliquant comme un bouton au lieu d’être sélectionnés. Pour ce faire, définissez SelectionMode sur None, la propriété IsItemClickEnabled sur true et gérez l’événement ItemClick .

Pour obtenir plus d’informations et des exemples, consultez Comment modifier le mode d’interaction.

Voir aussi

• SelectedItems
• SelectedItem
• SelectedIndex
• SelectionChanged
• Comment modifier le mode d’interaction