ListViewBase.SelectionMode 属性

  • 参考

定义

命名空间:
Microsoft.UI.Xaml.Controls
编辑

获取或设置 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" />

属性值

ListViewSelectionMode

ListViewSelectionMode 枚举值之一。 默认值为 “单选 ”。

注解

默认情况下，用户可以在视图中选择单个项。 可以将 SelectionMode 属性设置为 ListViewSelectionMode 枚举值，以启用多选或禁用选择。 下面是选择模式值。

  • 用户可以使用空格键、鼠标单击或触摸点击来选择单个项。
  • 用户可以使用向下轻扫手势取消选择项目。
按 Ctrl 时：
  • 用户可以使用空格键、鼠标单击或触摸点击来取消选择项目。
  • 通过使用箭头键，用户可以独立于选择来移动焦点。
  • 用户可以使用空格键、鼠标单击或触摸点击来选择多个项目，以在聚焦项目上切换选择。
  • 通过使用箭头键，用户可以独立于选择来移动焦点。
  • 行为与
    • 用户可以使用空格键、鼠标单击或触摸点击来选择多个项目，以在聚焦项目上切换选择。
    • 通过使用箭头键，用户可以独立于选择来移动焦点。
    按 Shift 时：
    • 用户可以通过先后单击或点击选择中的第一个和最后一个项目来选择多个连续项目。
    • 通过使用箭头键，用户可以创建从在按下 Shift 时选择的项目开始的连续选择。

注意

仅当 IsSwipeEnabled为 true 时，才会启用触摸交互。

如果 SelectionMode 为 None， 并且 CanDragItems 和 CanReorderItems 为 false，则应将 IsSwipeEnabled 设置为 false 以提高应用性能。 有关详细信息，请参阅 IsSwipeEnabled 属性。

当 SelectionMode 为 Single 时，请使用 Selector.SelectedItem 属性获取所选项目。 当 SelectionMode 为 Multiple 或 Extended 时，请使用 SelectedItems 属性获取所选项。

禁用项目选择后，可以让项响应用户单击时像按钮一样，而不是被选中。 为此，请将 SelectionMode 设置为 None，IsItemClickEnabled 属性设置为 true，并处理 ItemClick 事件。

有关详细信息和示例，请参阅 如何更改交互模式。

适用于

另请参阅