Selector.SelectedIndex Eigenschaft

Definition

Ruft den Index des ersten Elements in der aktuellen Auswahl ab bzw. legt diesen fest, oder gibt eine negative Eins ("-1") zurück, falls die Auswahl leer ist.Gets or sets the index of the first item in the current selection or returns negative one (-1) if the selection is empty.

public:
 property int SelectedIndex { int get(); void set(int value); };
[System.ComponentModel.Bindable(true)]
[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public int SelectedIndex { get; set; }
member this.SelectedIndex : int with get, set
Public Property SelectedIndex As Integer

Eigenschaftswert

Der Index des ersten Elements in der aktuellen Auswahl.The index of first item in the current selection. Der Standardwert ist -1.The default value is negative one (-1).

Attribute

Beispiele

Im folgenden Beispiel wird eine ListBox erstellt und die SelectedIndex-Eigenschaft auf 1 festgelegt, wodurch das zweite Element im ListBox ausgewählt wird.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>

Im folgenden Beispiel wird die SelectedIndex-Eigenschaft verwendet, um zu bestimmen, ob das Element bei Index 0 das erste Element in der Auswahl ist.The following example uses the SelectedIndex property to determine whether the item at index 0 is the first item in the selection.

if (lb.SelectedIndex == 0)
{
    Item.Content = "Index 0";
}
If lb.SelectedIndex = 0 Then
    Item.Content = "Index 0"

Hinweise

Wenn ein Selector die Auswahl eines einzelnen Elements unterstützt, gibt die SelectedIndex-Eigenschaft den Index des ausgewählten Elements zurück.If a Selector supports selecting a single item, the SelectedIndex property returns the index of the selected item. Wenn eine Selector mehrere Auswahlmöglichkeiten unterstützt, gibt SelectedIndex den Index des Elements zurück, das der Benutzer zuerst ausgewählt hat.If a Selector supports multiple selections, SelectedIndex returns the index of the item that the user selected first.

Durch Festlegen von SelectedIndex in einem Selector, der mehrere Auswahlmöglichkeiten unterstützt, werden vorhandene ausgewählte Elemente gelöscht, und die Auswahl wird auf das vom Index angegebene Element festgelegt.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 gibt-1 zurück, wenn die Auswahl leer ist.SelectedIndex returns -1 if selection is empty.

Wenn Sie SelectedIndex auf einen Wert festlegen, der kleiner als-1 ist, wird ein ArgumentException ausgelöst.If you set SelectedIndex to a value less that -1, an ArgumentException is thrown. Wenn Sie SelectedIndex auf einen Wert festlegen, der gleich oder größer als die Anzahl der untergeordneten Elemente ist, wird der Wert ignoriert.If you set SelectedIndex to a value equal or greater than the number of child elements, the value is ignored.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field SelectedIndexProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true BindsTwoWayByDefault, JournalBindsTwoWayByDefault, Journal

Gilt für: