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.
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
Einer der SelectionMode-Werte. Der Standardwert ist SelectionMode.One
.
Ausnahmen
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 listBox1
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 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.MultiExtended
festgelegt 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.MultiSimple
festgelegt ist, wird ein Element in der Liste durch Klicken oder Drücken der LEERTASTE ausgewählt oder deaktiviert.