ListBox.SelectionMode Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft das Verfahren für die Auswahl von Elementen in ListBox ab oder legt dieses fest.

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

Eigenschaftswert

SelectionMode

Einer der SelectionMode-Werte. Der Standardwert ist SelectionMode.One.

Ausnahmen

InvalidEnumArgumentException

Der zugewiesene Wert ist keiner der SelectionMode-Werte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der GetSelected -Methode ermittelt wird, welche Elemente in einem ListBox ausgewählt werden, um die elemente auszuwählen, die nicht ausgewählt sind, und die Auswahl der ausgewählten Elemente aufzuheben. Das Beispiel veranschaulicht auch die Verwendung der SelectionMode -Eigenschaft, um mehr ListBox als ein ausgewähltes Element zu aktivieren, und verwendet die Sorted -Eigenschaft, um zu veranschaulichen, wie Elemente in einem ListBox automatisch sortiert werden. Dieses Beispiel erfordert, dass ein ListBoxFormular mit dem Namen listBox1hinzugefügt wurde und dass die InitializeMyListBox im Beispiel definierte Methode aus dem Load Ereignis des Formulars aufgerufen wird.

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

Hinweise

Mit SelectionMode der -Eigenschaft können Sie bestimmen, wie viele Elemente in einem ListBox Benutzer gleichzeitig ausgewählt werden können und wie der Benutzer mehrere Auswahlen treffen kann. Wenn die -Eigenschaft auf festgelegt ist, wird die Auswahl vom zuvor ausgewählten Element auf das zuvor ausgewählte Element auf das aktuelle Element erweitert. Wenn die SelectionMode -Eigenschaft auf SelectionMode.MultiExtendedfestgelegt ist, wird durch Drücken der UMSCHALTTASTE oder durch Drücken der UMSCHALTTASTE eine der Pfeiltasten (NACH-OBEN, NACH-UNTEN, NACH-LINKS- und NACH-RECHTS-TASTE) erweitert. Durch Drücken von STRG und Klicken auf die Maus wird ein Element in der Liste ausgewählt oder deaktiviert. Wenn die Eigenschaft auf SelectionMode.MultiSimplefestgelegt ist, wird ein Element in der Liste durch Klicken oder Drücken der LEERTASTE ausgewählt oder deaktiviert.

Weitere Informationen

• SelectionMode