ListBox.SelectedIndex Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define o índice baseado em zero do item selecionado no momento em um ListBox.

public:
 virtual property int SelectedIndex { int get(); void set(int value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
public override int SelectedIndex { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.Browsable(false)>]
member this.SelectedIndex : int with get, set
Public Overrides Property SelectedIndex As Integer

Valor da propriedade

Int32

O índice baseado em zero do item selecionado no momento. Um valor de um negativo (-1) é retornado se nenhum item é selecionado.

Atributos
BindableAttribute BrowsableAttribute

Exceções

ArgumentOutOfRangeException

O valor atribuído é menor que -1 ou maior ou igual à contagem de itens.

ArgumentException

A propriedade SelectionMode está definida como None.

Exemplos

O exemplo de código a seguir demonstra como usar a SelectedIndex propriedade com a TopIndex propriedade para mover o item atualmente selecionado para a parte superior da lista de itens na área de exibição da ListBox. O exemplo demonstra ainda mais como remover itens usando o RemoveAt método da System.Windows.Forms.ListBox.ObjectCollection classe e como limpar toda a seleção de item usando o ClearSelected método. Primeiro, o código move o item selecionado no momento para a ListBox parte superior da lista. Em seguida, o código remove todos os itens antes do item selecionado no momento e limpa todas as seleções no ListBox. Este exemplo exige que um ListBox item que contém seja adicionado a um formulário e que um item esteja selecionado no momento.ListBox

private:
   void RemoveTopItems()
   {
      // Determine if the currently selected item in the ListBox 
      // is the item displayed at the top in the ListBox.
      if ( listBox1->TopIndex != listBox1->SelectedIndex )

      // Make the currently selected item the top item in the ListBox.
      listBox1->TopIndex = listBox1->SelectedIndex;

      // Remove all items before the top item in the ListBox.
      for ( int x = (listBox1->SelectedIndex - 1); x >= 0; x-- )
      {
         listBox1->Items->RemoveAt( x );
      }

      // Clear all selections in the ListBox.
      listBox1->ClearSelected();
   }

private void RemoveTopItems()
{
   // Determine if the currently selected item in the ListBox 
   // is the item displayed at the top in the ListBox.
   if (listBox1.TopIndex != listBox1.SelectedIndex)
      // Make the currently selected item the top item in the ListBox.
      listBox1.TopIndex = listBox1.SelectedIndex;

   // Remove all items before the top item in the ListBox.
   for (int x = (listBox1.SelectedIndex -1); x >= 0; x--)
   {
      listBox1.Items.RemoveAt(x);
   }

   // Clear all selections in the ListBox.
   listBox1.ClearSelected();
}

Private Sub RemoveTopItems()
   ' Determine if the currently selected item in the ListBox 
   ' is the item displayed at the top in the ListBox.
   If listBox1.TopIndex <> listBox1.SelectedIndex Then
      ' Make the currently selected item the top item in the ListBox.
      listBox1.TopIndex = listBox1.SelectedIndex
   End If
   ' Remove all items before the top item in the ListBox.
   Dim x As Integer
   For x = listBox1.SelectedIndex - 1 To 0 Step -1
      listBox1.Items.RemoveAt(x)
   Next x

   ' Clear all selections in the ListBox.
   listBox1.ClearSelected()
End Sub

Comentários

Para um padrão ListBox, você pode usar essa propriedade para determinar o índice do item selecionado no ListBox. Se a SelectionMode propriedade do ListBox é definida como SelectionMode.MultiSimple ou SelectionMode.MultiExtended (o que indica uma seleção ListBoxmúltipla) e vários itens são selecionados na lista, essa propriedade pode retornar o índice para qualquer item selecionado.

Para recuperar uma coleção que contém os índices de todos os itens selecionados em uma seleção ListBoxmúltipla, use a SelectedIndices propriedade. Se você quiser obter o item que está selecionado no momento, ListBoxuse a SelectedItem propriedade. Além disso, você pode usar a SelectedItems propriedade para obter todos os itens selecionados em uma seleção ListBoxmúltipla.

Aplica-se a

Confira também