通过

如何更改选择模式 (HTML)

  • 项目

[ 本文适用于编写 Windows 运行时应用的 Windows 8.x 和 Windows Phone 8.x 开发人员。如果你要针对 Windows 10 进行开发，请参阅 最新文档 ]

ListView 控件的 selectionMode 属性指定用户如何在列表中选择项目。

你需要了解的内容

技术

先决条件

说明

如何更改选择模式

selectionMode 属性支持下列值，这些值由 SelectionMode 枚举定义：

术语 描述

无

项目不能进行选择。

单个

只能选择一个项目。单击某个项目会选择该项目。

多个

可以选择多个项目。单击其他项目会将它们添加到所选内容中。

 

若要在 HTML 中指定选择模式，请使用 data-win-options 属性将 selectionMode 设置为所允许的枚举值之一的字符串表示形式，例如 "none" 或 "single"。

Hh465449.wedge(zh-cn,WIN.10).gif在 HTML 中指定选择模式

  • 以下示例将选择模式设置为只能选择单个项。

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

若要在 JavaScript 中指定选择模式，请检索该控件，并设置它的 selectionMode 属性。

Hh465449.wedge(zh-cn,WIN.10).gif在 JavaScript 中指定选择模式

  • 下一个示例会将选择模式设置为只能选择单个项。

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

相关主题

快速入门：添加 ListView