ListBox.SelectionMode Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
Une des valeurs de l'objet SelectionMode. La valeur par défaut est SelectionMode.One
.
Exceptions
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) == 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
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.MultiExtended
valeur , 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.MultiSimple
valeur , 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.