Selector.SelectedIndex Propriedade

Definição

Obtém ou define o índice do primeiro item na seleção atual ou retorna menos um (-1) se a seleção atual estiver vazia.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

Valor da propriedade

Int32

O índice do primeiro item na seleção atual.The index of first item in the current selection. O valor padrão é um negativo (-1).The default value is negative one (-1).

Atributos

Exemplos

O exemplo a seguir cria um ListBox e define a propriedade SelectedIndex como 1, que seleciona o segundo item na ListBox.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>

O exemplo a seguir usa a propriedade SelectedIndex para determinar se o item no índice 0 é o primeiro item na seleção.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"

Comentários

Se um Selector der suporte à seleção de um único item, a propriedade SelectedIndex retornará o índice do item selecionado.If a Selector supports selecting a single item, the SelectedIndex property returns the index of the selected item. Se um Selector oferecer suporte a várias seleções, SelectedIndex retornará o índice do item que o usuário selecionou primeiro.If a Selector supports multiple selections, SelectedIndex returns the index of the item that the user selected first.

A configuração SelectedIndex em uma Selector que dá suporte a várias seleções limpa os itens selecionados existentes e define a seleção para o item especificado pelo índice.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 retornará-1 se a seleção estiver vazia.SelectedIndex returns -1 if selection is empty.

Se você definir SelectedIndex como um valor menor que-1, um ArgumentException será gerado.If you set SelectedIndex to a value less that -1, an ArgumentException is thrown. Se você definir SelectedIndex como um valor igual ou maior que o número de elementos filho, o valor será ignorado.If you set SelectedIndex to a value equal or greater than the number of child elements, the value is ignored.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field SelectedIndexProperty
Propriedades de metadados definidas como trueMetadata properties set to true BindsTwoWayByDefault, JournalBindsTwoWayByDefault, Journal

Aplica-se a