ListBox.SelectionMode Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o método no qual os itens são selecionados no ListBox.

public:
 virtual property System::Windows::Forms::SelectionMode SelectionMode { System::Windows::Forms::SelectionMode get(); void set(System::Windows::Forms::SelectionMode value); };

public virtual System.Windows.Forms.SelectionMode SelectionMode { get; set; }

member this.SelectionMode : System.Windows.Forms.SelectionMode with get, set

Public Overridable Property SelectionMode As SelectionMode

Valor da propriedade

SelectionMode

Um dos valores de SelectionMode. O padrão é SelectionMode.One.

Exceções

InvalidEnumArgumentException

O valor atribuído não é um dos valores SelectionMode.

Exemplos

O exemplo de código a seguir demonstra como usar o GetSelected método para determinar quais itens em um ListBox são selecionados para selecionar os itens que não estão selecionados e desmarcar os itens selecionados. O exemplo também demonstra o uso da SelectionMode propriedade para permitir que um ListBox tenha mais de um item selecionado e usa a Sorted propriedade para demonstrar como classificar itens em um ListBox automaticamente. Este exemplo exige que um ListBox, chamado listBox1, tenha sido adicionado a um formulário e que o InitializeMyListBox método definido no exemplo seja chamado do Load evento do formulário.

private:
   void InitializeMyListBox()
   {
      // Add items to the ListBox.
      listBox1->Items->Add( "A" );
      listBox1->Items->Add( "C" );
      listBox1->Items->Add( "E" );
      listBox1->Items->Add( "F" );
      listBox1->Items->Add( "G" );
      listBox1->Items->Add( "D" );
      listBox1->Items->Add( "B" );

      // Sort all items added previously.
      listBox1->Sorted = true;

      // Set the SelectionMode to select multiple items.
      listBox1->SelectionMode = SelectionMode::MultiExtended;

      // Select three initial items from the list.
      listBox1->SetSelected( 0, true );
      listBox1->SetSelected( 2, true );
      listBox1->SetSelected( 4, true );

      // Force the ListBox to scroll back to the top of the list.
      listBox1->TopIndex = 0;
   }

   void InvertMySelection()
   {
      // Loop through all items the ListBox.
      for ( int x = 0; x < listBox1->Items->Count; x++ )
      {
         // Select all items that are not selected,
         // deselect all items that are selected.
         listBox1->SetSelected( x,  !listBox1->GetSelected( x ) );
      }
      listBox1->TopIndex = 0;
   }

private void InitializeMyListBox()
{
   // Add items to the ListBox.
   listBox1.Items.Add("A");
   listBox1.Items.Add("C");
   listBox1.Items.Add("E");
   listBox1.Items.Add("F");
   listBox1.Items.Add("G");
   listBox1.Items.Add("D");
   listBox1.Items.Add("B");

   // Sort all items added previously.
   listBox1.Sorted = true;

   // Set the SelectionMode to select multiple items.
   listBox1.SelectionMode = SelectionMode.MultiExtended;

   // Select three initial items from the list.
   listBox1.SetSelected(0,true);
   listBox1.SetSelected(2,true);
   listBox1.SetSelected(4,true);

   // Force the ListBox to scroll back to the top of the list.
   listBox1.TopIndex=0;
}

private void InvertMySelection()
{
   // Loop through all items the ListBox.
   for (int x = 0; x < listBox1.Items.Count; x++)
   {
      // Determine if the item is selected.
      if(listBox1.GetSelected(x) == true)
         // Deselect all items that are selected.
         listBox1.SetSelected(x,false);      
      else
         // Select all items that are not selected.
         listBox1.SetSelected(x,true);
   }
   // Force the ListBox to scroll back to the top of the list.
   listBox1.TopIndex=0;
}

Private Sub InitializeMyListBox()
   ' Add items to the ListBox.
   listBox1.Items.Add("A")
   listBox1.Items.Add("C")
   listBox1.Items.Add("E")
   listBox1.Items.Add("F")
   listBox1.Items.Add("G")
   listBox1.Items.Add("D")
   listBox1.Items.Add("B")

   ' Sort all items added previously.
   listBox1.Sorted = True

   ' Set the SelectionMode to select multiple items.
   listBox1.SelectionMode = SelectionMode.MultiExtended

   ' Select three initial items from the list.
   listBox1.SetSelected(0, True)
   listBox1.SetSelected(2, True)
   listBox1.SetSelected(4, True)

   ' Force the ListBox to scroll back to the top of the list.
   listBox1.TopIndex = 0
End Sub

Private Sub InvertMySelection()

   Dim x As Integer
   ' Loop through all items the ListBox.
   For x = 0 To listBox1.Items.Count - 1

      ' Determine if the item is selected.
      If listBox1.GetSelected(x) = True Then
         ' Deselect all items that are selected.
         listBox1.SetSelected(x, False)
      Else
         ' Select all items that are not selected.
         listBox1.SetSelected(x, True)
      End If
   Next x
   ' Force the ListBox to scroll back to the top of the list.
   listBox1.TopIndex = 0
End Sub

Comentários

A SelectionMode propriedade permite determinar quantos itens um ListBox usuário pode selecionar ao mesmo tempo e como o usuário pode fazer várias seleções. Quando a SelectionMode propriedade é definida como , pressionar SHIFT e clicar no mouse ou pressionar SHIFT e uma das teclas de direção (SETA PARA CIMA, SETA PARA SelectionMode.MultiExtendedBAIXO, SETA PARA A ESQUERDA e SETA PARA A DIREITA) estende a seleção do item selecionado anteriormente para o item atual. Pressionar CTRL e clicar no mouse seleciona ou desmarca um item na lista. Quando a propriedade é definida como SelectionMode.MultiSimple, um mouse clica ou pressiona a BARRA DE ESPAÇOS seleciona ou desmarca um item na lista.

Confira também

• SelectionMode