Selector.SelectedIndex Propriedade

Referência

Definição

Namespace:: System.Windows.Controls.Primitives

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

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; }

[<System.ComponentModel.Bindable(true)>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
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. O valor padrão é um negativo (-1).

Atributos: BindableAttribute LocalizabilityAttribute

Exemplos

O exemplo a ListBoxseguir cria um ListBox e define a SelectedIndex propriedade como 1, que seleciona o segundo item no .

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

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

If lb.SelectedIndex = 0 Then
    Item.Content = "Index 0"

Comentários

Se houver Selector suporte para a seleção de um único item, a SelectedIndex propriedade retornará o índice do item selecionado. Se um Selector suporte a várias seleções, SelectedIndex retorna o índice do item que o usuário selecionou primeiro.

A configuração SelectedIndex em um 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. SelectedIndex retornará -1 se a seleção estiver vazia.

Se você definir SelectedIndex como um valor menor que -1, um ArgumentException será gerado. Se você definir SelectedIndex como um valor igual ou maior que o número de elementos filho, o valor será ignorado.

Informações da propriedade de dependência


Campo identificador	SelectedIndexProperty
Propriedades de metadados definidas como `true`	BindsTwoWayByDefault, Journal

Aplica-se a

Partilhar via