Selector.SelectedItem Property

Definition

Gets or sets the first item in the current selection or returns null if the selection is empty.

C#
[System.ComponentModel.Bindable(true)]
public object SelectedItem { get; set; }

Property Value

The first item in the current selection or null if the selection is empty.

Attributes

Examples

The following example gets the SelectedItem from a ListBox.

C#
void PrintText(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem lbi = ((sender as ListBox).SelectedItem as ListBoxItem);
    tb.Text = "   You selected " + lbi.Content.ToString() + ".";
}

Remarks

If a Selector supports selecting a single item, the SelectedItem property returns the selected item. If a Selector supports multiple selections, SelectedItem returns the item that the user selected first.

Setting SelectedItem in a Selector that supports multiple selections clears existing selected items and sets the selection to the item specified.

Dependency Property Information

Item Value
Identifier field SelectedItemProperty
Metadata properties set to true BindsTwoWayByDefault, Journal

Applies to

Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9