ListBox.SelectionMode-Eigenschaft

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Overridable Property SelectionMode As SelectionMode
'Usage
Dim instance As ListBox
Dim value As SelectionMode

value = instance.SelectionMode

instance.SelectionMode = value

public virtual SelectionMode SelectionMode { get; set; }

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

/** @property */
public SelectionMode get_SelectionMode ()

/** @property */
public void set_SelectionMode (SelectionMode value)

public function get SelectionMode () : SelectionMode

public function set SelectionMode (value : SelectionMode)

Eigenschaftenwert

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

Ausnahmen

Ausnahmetyp	Bedingung
InvalidEnumArgumentException	Der zugewiesene Wert ist kein SelectionMode-Wert.

Hinweise

Mithilfe der SelectionMode-Eigenschaft können Sie die Anzahl der Elemente in ListBox bestimmen, die ein Benutzer gleichzeitig auswählen kann. Außerdem können Sie das Verfahren für die Mehrfachauswahl durch den Benutzer bestimmen. Wenn die SelectionMode-Eigenschaft auf SelectionMode.MultiExtended festgelegt ist, können Sie die Auswahl vom zuvor ausgewählten bis zum aktuellen Element erweitern, indem Sie die UMSCHALTTASTE drücken und mit der Maus klicken, oder die UMSCHALTTASTE und eine der Pfeiltasten drücken (NACH-OBEN-TASTE, NACH-UNTEN-TASTE, NACH-LINKS-TASTE und NACH-RECHTS-TASTE). Wenn Sie die STRG-TASTE drücken und mit der Maus klicken, wird ein Element in der Liste ausgewählt bzw. dessen Auswahl aufgehoben. Wenn die Eigenschaft auf SelectionMode.MultiSimple festgelegt ist, wird durch einen Mausklick oder Drücken der LEERTASTE ein Element in der Liste ausgewählt bzw. dessen Auswahl aufgehoben.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der GetSelected-Methode die in einer ListBox ausgewählten Elemente bestimmt werden, damit die nicht ausgewählten Elemente ausgewählt werden können und die Auswahl der ausgewählten Elemente aufgehoben werden kann. Außerdem wird veranschaulicht, wie mit der SelectionMode-Eigenschaft für eine ListBox das Auswählen mehrerer Elemente ermöglicht wird. Mithilfe der Sorted-Eigenschaft wird das automatische Sortieren von Elementen in einer ListBox dargestellt. Für dieses Beispiel muss einem Formular die ListBoxlistBox1 hinzugefügt werden, und die im Beispiel definierte InitializeMyListBox-Methode muss aus dem Load-Ereignis des Formulars aufgerufen werden.

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

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:
   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.get_Items().Add("A");
    listBox1.get_Items().Add("C");
    listBox1.get_Items().Add("E");
    listBox1.get_Items().Add("F");
    listBox1.get_Items().Add("G");
    listBox1.get_Items().Add("D");
    listBox1.get_Items().Add("B");

    // Sort all items added previously.
    listBox1.set_Sorted(true);

    // Set the SelectionMode to select multiple items.
    listBox1.set_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.set_TopIndex(0);
} //InitializeMyListBox

private void InvertMySelection()
{
    // Loop through all items the ListBox.
    for (int x = 0; x < listBox1.get_Items().get_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.set_TopIndex(0);
} //InvertMySelection

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ListBox-Klasse
ListBox-Member
System.Windows.Forms-Namespace
SelectionMode