ListViewBase.SelectionMode Propriété

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml.Controls
Modifier

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 multi-sélection ou désactiver la sélection. Voici les valeurs du mode de sélection.

  • 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.
  • 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.
  • Le comportement est le même que
    • 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.
    Tout en appuyant 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 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.

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

Pour plus d’informations et d’exemples, consultez Comment changer le mode d’interaction.

S’applique à

Voir aussi