Selector.SelectedIndex Property
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Gets or sets the index of the first item in the current selection or returns negative one (-1) if the selection is empty.
Namespace: System.Windows.Controls.Primitives
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
[LocalizabilityAttribute(LocalizationCategory.NeverLocalize)] [BindableAttribute(true)] public int SelectedIndex { get; set; }
<object SelectedIndex="int" .../>
Property Value
Type: System.Int32The index of first item in the current selection. The default value is negative one (-1).
If a Selector supports selecting a single item, the SelectedIndex property returns the index of the selected item. If a Selector supports multiple selections, SelectedIndex returns the index of the item that the user selected first.
Setting SelectedIndex in a Selector that supports multiple selections clears existing selected items and sets the selection to the item specified by the index. SelectedIndex returns -1 if selection is empty.
If you set SelectedIndex to a value less that -1, an ArgumentException is thrown. If you set SelectedIndex to a value equal or greater than the number of child elements, the value is ignored.
The following example creates a ListBox and sets the SelectedIndex property to 1, which selects the second item in the ListBox.
<ListBox Margin="10,0,0,5" SelectedIndex="1" Name="listBox1" VerticalAlignment="Top" Grid.Column="0" Grid.Row="4"> <ListBoxItem>Item 0</ListBoxItem> <ListBoxItem>Item 1</ListBoxItem> <ListBoxItem>Item 2</ListBoxItem> <ListBoxItem>Item 3</ListBoxItem> </ListBox>
The following example uses the SelectedIndex property to determine whether the item at index 0 is the first item in the selection.
Windows 8 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
