So wird’s gemacht: Ändern des Auswahlmodus (HTML)
[ Dieser Artikel richtet sich an Windows 8.x- und Windows Phone 8.x-Entwickler, die Windows-Runtime-Apps schreiben. Wenn Sie für Windows 10 entwickeln, finden Sie weitere Informationen unter neueste Dokumentation ]
Die selectionMode-Eigenschaft des ListView-Steuerelements gibt an, wie Benutzer Elemente aus der Liste auswählen können.
Wissenswertes
Technologien
Voraussetzungen
- Es wird davon ausgegangen, dass Sie ein ListView-Steuerelement erstellen können. Weitere Informationen finden Sie im Schnellstart zum Hinzufügen von ListView-Steuerelementen.
Anweisungen
Ändern des Auswahlmodus
Die selectionMode-Eigenschaft unterstützt die folgenden Werte, die von der SelectionMode-Enumeration definiert werden:
Benennung | Beschreibung |
---|---|
keine |
Es können keine Elemente ausgewählt werden. |
einzeln |
Es kann nur ein Element ausgewählt werden. Durch Klicken auf ein Element erfolgt die Auswahl dieses Elements. |
mehrfach |
Es können mehrere Elemente ausgewählt werden. Durch Klicken auf weitere Elemente werden auch diese ausgewählt. |
Wenn Sie den Auswahlmodus in HTML festlegen möchten, verwenden Sie das data-win-options-Attribut, um selectionMode auf eine Zeichenfolgendarstellung mit einem der zulässigen Enumerationswerte wie "none" oder "single" festzulegen.
So geben Sie den Auswahlmodus in HTML an
In diesem Beispiel wird der Auswahlmodus festgelegt, sodass nur ein einziges Element ausgewählt werden kann.
<div id="basicListView" data-win-control="WinJS.UI.ListView" data-win-options="{ itemDataSource : DataExample.itemList.dataSource, itemTemplate: select('#mediumListIconTextTemplate'), selectionMode: 'single'}"> </div>
Wenn Sie den Auswahlmodus in JavaScript angeben möchten, rufen Sie das Steuerelement ab, und legen Sie seine selectionMode-Eigenschaft fest.
So geben Sie den Auswahlmodus in JavaScript an
Im nächsten Beispiel wird der Auswahlmodus festgelegt, sodass nur ein einziges Element ausgewählt werden kann.
var myListView = document.getElementById("basicListView1").winControl; myListView.selectionMode = WinJS.UI.SelectionMode.single;