Comment modifier le mode de sélection (HTML)

Article
03/04/2016

[ Cet article est destiné aux développeurs Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

La propriété selectionMode du contrôle ListView définit de quelle façon l’utilisateur peut sélectionner les éléments d’une liste.

Ce que vous devez savoir

Technologies

Prérequis

Nous partons du principe que vous savez créer un contrôle ListView. Pour plus d’informations,voir Démarrage rapide : ajout d’un contrôle ListView.

Instructions

Modifier le mode de sélection

La propriété selectionMode prend en charge les valeurs suivantes, tel que défini par l’énumération SelectionMode :

Terme	Description
none	Les éléments ne peuvent pas être sélectionnés.
single	Seul un élément peut être sélectionné. L’élément sur lequel vous cliquez est ajouté à la sélection.
multi	Plusieurs éléments peuvent être sélectionnés. Les éléments sur lesquels vous cliquez sont ajoutés à la sélection.

Pour spécifier le mode de sélection au format HTML, utilisez l’attribut data-win-options afin de définir selectionMode sur la représentation de chaîne de l’une des valeurs d’énumération autorisées, telles que "none" ou "single".

Hh465449.wedge(fr-fr,WIN.10).gif Pour spécifier le mode de sélection au format HTML

Cet exemple définit le mode de sélection de façon à ce qu’un seul élément puisse être sélectionné.

<div id="basicListView" 
    data-win-control="WinJS.UI.ListView"
    data-win-options="{ itemDataSource : DataExample.itemList.dataSource, itemTemplate: select('#mediumListIconTextTemplate'), selectionMode: 'single'}">
</div>

Pour spécifier le mode de sélection en JavaScript, récupérez le contrôle et définissez sa propriété selectionMode.

Hh465449.wedge(fr-fr,WIN.10).gif Pour spécifier le mode de sélection en JavaScript

L’exemple suivant définit le mode de sélection de façon à ce qu’un seul élément puisse être sélectionné.

var myListView = document.getElementById("basicListView1").winControl;
myListView.selectionMode = WinJS.UI.SelectionMode.single;

Rubriques associées

Démarrage rapide : ajout d’un contrôle ListView

Partager via