Windows Dev Center

ListBox.SelectionMode property

Gets or sets the selection behavior for the ListBox control.

Syntax


public SelectionMode SelectionMode { get; set; }


<ListBox SelectionMode="selectionModeValue"/>

XAML Values

selectionModeValue

A named constant of the SelectionMode enumeration, such as Extended.

Property value

Type: SelectionMode

One of the SelectionMode values.

Remarks

By default, a user can select a single item in a ListBox. You can set the ListBox.SelectionMode property to a SelectionMode enumeration value to enable multi-selection. Here are the selection mode values.

Single

A user can select a single item using the space bar, mouse click, or touch tap. A user can deselect an item using a downward swipe gesture.

While pressing Ctrl: a user can deselect the item by using the space bar, mouse click, or touch tap. Using the arrow keys, a user can move focus independently of selection.

Multiple

A user can select multiple items using the space bar, mouse click, or touch tap to toggle selection on the focused item. Using the arrow keys, a user can move focus independently of selection.

Extended

With no modifier keys: the behavior is the same as Single selection.

While pressing Ctrl: a user can select multiple items using the space bar, mouse click, or touch tap to toggle selection on the focused item. Using the arrow keys, a user can move focus independently of selection.

While pressing Shift: a user can select multiple contiguous items by clicking or tapping the first item in the selection and then the last item in the selection. Using the arrow keys, a user can create a contiguous selection starting with the item selected when Shift is pressed.

 

When SelectionMode is Single, use the Selector.SelectedItem property to get the item that's selected. When SelectionMode is Multiple or Extended, use the SelectedItems property to get the items that are selected.

Requirements (Windows 10 device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadata

Windows.winmd

See also

ListBox
Selector.SelectedItem
SelectedItems

 

 

Show:
© 2015 Microsoft