ListBox.SelectionMode 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

获取或设置 ListBox 控件的选择行为。

public:
 property SelectionMode SelectionMode { SelectionMode get(); void set(SelectionMode value); };

SelectionMode SelectionMode();

void SelectionMode(SelectionMode value);

public SelectionMode SelectionMode { get; set; }

var selectionMode = listBox.selectionMode;
listBox.selectionMode = selectionMode;

Public Property SelectionMode As SelectionMode

<ListBox SelectionMode="selectionModeValue"/>

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

选择模式	行为
Single	用户可以使用空格键、鼠标单击或触摸点击来选择单个项。用户可以使用向下轻扫手势取消选择项目。 - 按 Ctrl 时：用户可以使用空格键、鼠标单击或触摸点击来取消选择项目。通过使用箭头键，用户可以独立于选择来移动焦点。
多个	用户可以使用空格键、鼠标单击或触摸点击来选择多个项目，以在聚焦项目上切换选择。通过使用箭头键，用户可以独立于选择来移动焦点。
扩展	没有修饰键：行为与单选相同。 - 按 Ctrl 时：用户可以使用空格键、鼠标单击或触摸点击来选择多个项目，以切换焦点项目上的选择。通过使用箭头键，用户可以独立于选择来移动焦点。 - 按 Shift 时：用户可以通过单击或点击所选内容中的第一个项目，然后单击所选内容中的最后一项来选择多个连续项。通过使用箭头键，用户可以创建从在按下 Shift 时选择的项目开始的连续选择。

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