ListBox.SelectionMode Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der Methode, in der Elemente in der 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
Eigenschaftswert
Einer der SelectionMode Werte. Der Standardwert lautet SelectionMode.One.
Ausnahmen
Der zugewiesene Wert ist keiner der SelectionMode Werte.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die GetSelected Methode verwendet wird, um zu bestimmen, welche Elemente in einer ListBox Auswahl ausgewählt sind, um die nicht ausgewählten Elemente auszuwählen und die ausgewählten Elemente zu deaktivieren. Im Beispiel wird auch die Verwendung der SelectionMode Eigenschaft veranschaulicht, um ein ListBox ausgewähltes Element zu aktivieren und die Sorted Eigenschaft zu verwenden, um zu veranschaulichen, wie Elemente in einem ListBox automatischen Element sortiert werden. Dieses Beispiel erfordert, dass ein ListBoxbenanntes listBox1Formular einem Formular hinzugefü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))
// 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 der SelectionMode Eigenschaft können Sie bestimmen, wie viele Elemente in einem ListBox Benutzer gleichzeitig ausgewählt werden können und wie der Benutzer Mehrfachauswahl treffen kann. Wenn die SelectionMode Eigenschaft auf SelectionMode.MultiExtended festgelegt ist, wird durch Drücken der UMSCHALTTASTE oder Durchklicken der UMSCHALTTASTE und einer der Pfeiltasten (NACH-OBEN, NACH-UNTEN, NACH-LINKS- und NACH-RECHTS-TASTE) die Auswahl vom zuvor ausgewählten Element auf das aktuelle Element erweitert. Wenn Sie STRG drücken und mit der Maus klicken, wird ein Element in der Liste markiert oder deaktiviert. Wenn die Eigenschaft auf <