ListBox.SelectionMode Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ListBox.cs

Obtient ou définit la méthode dans laquelle des éléments sont sélectionnés dans 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

Valeur de propriété

SelectionMode

Une des valeurs de l'objet SelectionMode. La valeur par défaut est SelectionMode.One.

Exceptions

InvalidEnumArgumentException

La valeur assignée ne fait pas partie des valeurs SelectionMode.

Exemples

L’exemple de code suivant montre comment utiliser la GetSelected méthode pour déterminer quels éléments d’un ListBox sont sélectionnés afin de sélectionner les éléments qui ne sont pas sélectionnés et de désélectionner les éléments sélectionnés. L’exemple illustre également l’utilisation de la SelectionMode propriété pour permettre à un d’avoir ListBox plusieurs éléments sélectionnés et utilise la Sorted propriété pour montrer comment trier automatiquement des éléments dans un ListBox . Cet exemple nécessite qu’un ListBox, nommé listBox1, ait été ajouté à un formulaire et que la InitializeMyListBox méthode définie dans l’exemple soit appelée à partir de l’événement Load du formulaire.

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))
         // 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

Remarques

La SelectionMode propriété vous permet de déterminer le nombre d’éléments qu’un ListBox utilisateur peut sélectionner à la fois et comment l’utilisateur peut effectuer des sélections multiples. Lorsque la propriété a la SelectionModeSelectionMode.MultiExtendedvaleur , appuyez sur Maj et cliquez sur la souris ou appuyez sur Maj et l’une des touches de direction (flèche vers le haut, flèche bas, flèche gauche et flèche droite) étend la sélection de l’élément précédemment sélectionné à l’élément actif. Appuyez sur Ctrl et cliquez sur la souris pour sélectionner ou désélectionner un élément dans la liste. Lorsque la propriété a la SelectionMode.MultiSimplevaleur , un clic de souris ou une pression sur la barre d’espace permet de sélectionner ou de désélectionner un élément dans la liste.

Voir aussi

• SelectionMode