Share via


ItemsViewSelectionMode Enum

Definition

Defines constants that specify the selection mode of an ItemsView.

public enum class ItemsViewSelectionMode
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 327680)]
enum class ItemsViewSelectionMode
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 327680)]
public enum ItemsViewSelectionMode
Public Enum ItemsViewSelectionMode
Inheritance
ItemsViewSelectionMode
Attributes

Fields

Name Value Description
None 0

Item selection is disabled, whether it is through user interaction or programmatically.

Single 1

One or zero items can be selected.

Multiple 2

Zero, one, or more items can be selected.

Extended 3

Zero, one, or more items can be selected. Multiple selection requires the use of Ctrl or Shift modifier keys.

Remarks

This table describes how each mode behaves with and without modifier keys.

Name Behavior
Single With no modifier keys: A user can select a single item using the space bar, mouse click, or touch tap.
While pressing Ctrl: A user can toggle the selection if a single item by using the space bar, mouse click, or touch tap. Using the arrow keys, a user can move focus independently of selection.
Multiple With no modifier keys: A user can toggle the selection of a single item using the space bar, mouse click, or touch tap.
While pressing Ctrl: Using the arrow keys, a user can move focus independently of selection.
While pressing Shift: A user can select multiple items using a mouse click or touch tap.
Extended With no modifier keys: A user can select a single item using the space bar, mouse click, or touch tap. Any previous selections are cleared.
While pressing Ctrl: A user can toggle the selection of a single item by using the space bar, mouse click, or touch tap. Using the arrow keys, a user can move focus independently of selection.
While pressing Shift: A user can select multiple items using a mouse click or touch tap.

Applies to