ListView.MultiSelect 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 einen Wert ab, der angibt, ob mehrere Elemente ausgewählt werden können, oder legt diesen fest.
public:
property bool MultiSelect { bool get(); void set(bool value); };public bool MultiSelect { get; set; }member this.MultiSelect : bool with get, setPublic Property MultiSelect As BooleanEigenschaftswert
true, wenn mehrere Elemente im Steuerelement gleichzeitig ausgewählt werden können, andernfalls false. Der Standardwert ist true.
Beispiele
Im folgenden Codebeispiel wird ein ListView veranschaulicht, mit dem mehrere Elemente ausgewählt werden können. Das Beispiel veranschaulicht das Festlegen der HideSelection Eigenschaften und HeaderStyle . Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, das ein ListView Objekt mit dem Namen ListView1 und einen TextBox namen TextBox1enthält. Rufen Sie die InitializeListView -Methode über den Konstruktor oder Load die Methode des Formulars auf.
// This method adds two columns to the ListView, setting the Text
// and TextAlign, and Width properties of each ColumnHeader. The
// HeaderStyle property is set to NonClickable since the ColumnClick
// event is not handled. Finally the method adds ListViewItems and
// SubItems to each column.
void InitializeListView()
{
this->ListView1 = gcnew System::Windows::Forms::ListView;
this->ListView1->BackColor = System::Drawing::SystemColors::Control;
this->ListView1->Dock = System::Windows::Forms::DockStyle::Top;
this->ListView1->Location = System::Drawing::Point( 0, 0 );
this->ListView1->Name = "ListView1";
this->ListView1->Size = System::Drawing::Size( 292, 130 );
this->ListView1->TabIndex = 0;
this->ListView1->View = System::Windows::Forms::View::Details;
this->ListView1->MultiSelect = true;
this->ListView1->HideSelection = false;
this->ListView1->HeaderStyle = ColumnHeaderStyle::Nonclickable;
ColumnHeader^ columnHeader1 = gcnew ColumnHeader;
columnHeader1->Text = "Breakfast Item";
columnHeader1->TextAlign = HorizontalAlignment::Left;
columnHeader1->Width = 146;
ColumnHeader^ columnHeader2 = gcnew ColumnHeader;
columnHeader2->Text = "Price Each";
columnHeader2->TextAlign = HorizontalAlignment::Center;
columnHeader2->Width = 142;
this->ListView1->Columns->Add( columnHeader1 );
this->ListView1->Columns->Add( columnHeader2 );
array<String^>^foodList = {"Juice","Coffee","Cereal & Milk","Fruit Plate","Toast & Jelly","Bagel & Cream Cheese"};
array<String^>^foodPrice = {"1.09","1.09","2.19","2.49","1.49","1.49"};
for ( int count = 0; count < foodList->Length; count++ )
{
ListViewItem^ listItem = gcnew ListViewItem( foodList[ count ] );
listItem->SubItems->Add( foodPrice[ count ] );
ListView1->Items->Add( listItem );
}
this->Controls->Add( ListView1 );
}
// This method adds two columns to the ListView, setting the Text
// and TextAlign, and Width properties of each ColumnHeader. The
// HeaderStyle property is set to NonClickable since the ColumnClick
// event is not handled. Finally the method adds ListViewItems and
// SubItems to each column.
private void InitializeListView()
{
this.ListView1 = new System.Windows.Forms.ListView();
this.ListView1.BackColor = System.Drawing.SystemColors.Control;
this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
this.ListView1.Location = new System.Drawing.Point(0, 0);
this.ListView1.Name = "ListView1";
this.ListView1.Size = new System.Drawing.Size(292, 130);
this.ListView1.TabIndex = 0;
this.ListView1.View = System.Windows.Forms.View.Details;
this.ListView1.MultiSelect = true;
this.ListView1.HideSelection = false;
this.ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
ColumnHeader columnHeader1 = new ColumnHeader();
columnHeader1.Text = "Breakfast Item";
columnHeader1.TextAlign = HorizontalAlignment.Left;
columnHeader1.Width = 146;
ColumnHeader columnHeader2 = new ColumnHeader();
columnHeader2.Text = "Price Each";
columnHeader2.TextAlign = HorizontalAlignment.Center;
columnHeader2.Width = 142;
this.ListView1.Columns.Add(columnHeader1);
this.ListView1.Columns.Add(columnHeader2);
string[] foodList = new string[]{"Juice", "Coffee",
"Cereal & Milk", "Fruit Plate", "Toast & Jelly",
"Bagel & Cream Cheese"};
string[] foodPrice = new string[]{"1.09", "1.09", "2.19",
"2.49", "1.49", "1.49"};
for(int count=0; count < foodList.Length; count++)
{
ListViewItem listItem = new ListViewItem(foodList[count]);
listItem.SubItems.Add(foodPrice[count]);
ListView1.Items.Add(listItem);
}
this.Controls.Add(ListView1);
}
' This method adds two columns to the ListView, setting the Text
' and TextAlign, and Width properties of each ColumnHeader. The
' HeaderStyle property is set to NonClickable since the ColumnClick
' event is not handled. Finally the method adds ListViewItems and
' SubItems to each column.
Private Sub InitializeListView()
Me.ListView1 = New System.Windows.Forms.ListView
Me.ListView1.BackColor = System.Drawing.SystemColors.Control
Me.ListView1.Dock = System.Windows.Forms.DockStyle.Top
Me.ListView1.Location = New System.Drawing.Point(0, 0)
Me.ListView1.Name = "ListView1"
Me.ListView1.Size = New System.Drawing.Size(292, 130)
Me.ListView1.TabIndex = 0
Me.ListView1.View = System.Windows.Forms.View.Details
Me.ListView1.MultiSelect = True
Me.ListView1.HideSelection = False
ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable
Dim columnHeader1 As New ColumnHeader
With columnHeader1
.Text = "Breakfast Item"
.TextAlign = HorizontalAlignment.Left
.Width = 146
End With
Dim columnHeader2 As New ColumnHeader
With columnHeader2
.Text = "Price Each"
.TextAlign = HorizontalAlignment.Center
.Width = 142
End With
Me.ListView1.Columns.Add(columnHeader1)
Me.ListView1.Columns.Add(columnHeader2)
Dim foodList() As String = New String() {"Juice", "Coffee", _
"Cereal & Milk", "Fruit Plate", "Toast & Jelly", _
"Bagel & Cream Cheese"}
Dim foodPrice() As String = New String() {"1.09", "1.09", _
"2.19", "2.49", "1.49", "1.49"}
Dim count As Integer
For count = 0 To foodList.Length - 1
Dim listItem As New ListViewItem(foodList(count))
listItem.SubItems.Add(foodPrice(count))
ListView1.Items.Add(listItem)
Next
Me.Controls.Add(Me.ListView1)
End Sub
Hinweise
Wenn die MultiSelect -Eigenschaft auf truefestgelegt ist, können mehrere Elemente im ListView Steuerelement ausgewählt werden. Um mehrere Elemente auszuwählen, muss der Benutzer die STRG-TASTE gedrückt halten, während er auf die auszuwählenden Elemente klickt. Aufeinanderfolgende Elemente können ausgewählt werden, indem Sie auf das erste Element klicken, um auszuwählen, und dann, wenn Sie die UMSCHALTTASTE gedrückt halten, auf das letzte Element klicken, um auszuwählen. Sie können die Mehrfachauswahlfunktion verwenden, um mehrere Elemente im ListView Steuerelement auszuwählen und einen Vorgang für alle ausgewählten Elemente auszuführen. Beispielsweise kann der Benutzer mehrere Elemente auswählen und dann mit der rechten Maustaste auf ein ausgewähltes Element klicken, um ein Kontextmenü anzuzeigen, in dem eine Reihe von Aufgaben angezeigt wird, die für die ausgewählten Elemente ausgeführt werden können.
Um zu bestimmen, welche Elemente im ListView Steuerelement ausgewählt sind, verwenden Sie die SelectedItems -Eigenschaft. Mit SelectedItems der -Eigenschaft können Sie auf die zugreifen, die ListView.SelectedListViewItemCollection eine Liste der ausgewählten Elemente enthält. Wenn Sie die Indexpositionen anstelle der Elemente verwenden ListView.ListViewItemCollection möchten, können Sie die SelectedIndices -Eigenschaft verwenden, um auf die ListView.SelectedIndexCollectionzuzugreifen.
Wenn Sie mehrere Auswahlmöglichkeiten in nicht ListViewzulassen möchten, aber dem Benutzer dennoch eine Möglichkeit bieten möchten, mehrere Elemente auszuwählen, können Sie Kontrollkästchen anzeigen, indem Sie die CheckBoxes -Eigenschaft auf truefestlegen.
