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

• Erstellen Ihrer ersten Windows-Runtime-App mit JavaScript
• ListView

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:

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;
  

Verwandte Themen

Schnellstart: Hinzufügen von ListView-Steuerelementen