ListBox.Items 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 die Elemente der ListBox.
public:
property System::Windows::Forms::ListBox::ObjectCollection ^ Items { System::Windows::Forms::ListBox::ObjectCollection ^ get(); };public System.Windows.Forms.ListBox.ObjectCollection Items { get; }member this.Items : System.Windows.Forms.ListBox.ObjectCollectionPublic ReadOnly Property Items As ListBox.ObjectCollectionEigenschaftswert
Eine ListBox.ObjectCollection Darstellung der Elemente in der ListBox.
Beispiele
Das folgende Codebeispiel veranschaulicht das Erstellen eines ListBox Steuerelements, das mehrere Elemente in Spalten anzeigt und mehrere Elemente in der Liste des Steuerelements ausgewählt haben kann. Der Code für das Beispiel fügt der Methode Add der ListBox.ObjectCollection Klasse 50 Elemente hinzu ListBox und wählt dann drei Elemente aus der Liste mithilfe der SetSelected Methode aus. Der Code zeigt dann Werte aus der ListBox.SelectedObjectCollection Auflistung (über die SelectedItems Eigenschaft) und die ListBox.SelectedIndexCollection (über die SelectedIndices Eigenschaft) an. In diesem Beispiel ist erforderlich, dass sich der Code in einem Form.
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Create an instance of the ListBox.
ListBox^ listBox1 = gcnew ListBox;
// Set the size and location of the ListBox.
listBox1->Size = System::Drawing::Size( 200, 100 );
listBox1->Location = System::Drawing::Point( 10, 10 );
// Add the ListBox to the form.
this->Controls->Add( listBox1 );
// Set the ListBox to display items in multiple columns.
listBox1->MultiColumn = true;
// Set the selection mode to multiple and extended.
listBox1->SelectionMode = SelectionMode::MultiExtended;
// Shutdown the painting of the ListBox as items are added.
listBox1->BeginUpdate();
// Loop through and add 50 items to the ListBox.
for ( int x = 1; x <= 50; x++ )
{
listBox1->Items->Add( String::Format( "Item {0}", x ) );
}
listBox1->EndUpdate();
// Select three items from the ListBox.
listBox1->SetSelected( 1, true );
listBox1->SetSelected( 3, true );
listBox1->SetSelected( 5, true );
#if defined(DEBUG)
// Display the second selected item in the ListBox to the console.
System::Diagnostics::Debug::WriteLine( listBox1->SelectedItems[ 1 ] );
// Display the index of the first selected item in the ListBox.
System::Diagnostics::Debug::WriteLine( listBox1->SelectedIndices[ 0 ] );
#endif
}
private void button1_Click(object sender, System.EventArgs e)
{
// Create an instance of the ListBox.
ListBox listBox1 = new ListBox();
// Set the size and location of the ListBox.
listBox1.Size = new System.Drawing.Size(200, 100);
listBox1.Location = new System.Drawing.Point(10,10);
// Add the ListBox to the form.
this.Controls.Add(listBox1);
// Set the ListBox to display items in multiple columns.
listBox1.MultiColumn = true;
// Set the selection mode to multiple and extended.
listBox1.SelectionMode = SelectionMode.MultiExtended;
// Shutdown the painting of the ListBox as items are added.
listBox1.BeginUpdate();
// Loop through and add 50 items to the ListBox.
for (int x = 1; x <= 50; x++)
{
listBox1.Items.Add("Item " + x.ToString());
}
// Allow the ListBox to repaint and display the new items.
listBox1.EndUpdate();
// Select three items from the ListBox.
listBox1.SetSelected(1, true);
listBox1.SetSelected(3, true);
listBox1.SetSelected(5, true);
// Display the second selected item in the ListBox to the console.
System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems[1].ToString());
// Display the index of the first selected item in the ListBox.
System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices[0].ToString());
}
Private Sub button1_Click(sender As Object, e As System.EventArgs)
' Create an instance of the ListBox.
Dim listBox1 As New ListBox()
' Set the size and location of the ListBox.
listBox1.Size = New System.Drawing.Size(200, 100)
listBox1.Location = New System.Drawing.Point(10, 10)
' Add the ListBox to the form.
Me.Controls.Add(listBox1)
' Set the ListBox to display items in multiple columns.
listBox1.MultiColumn = True
' Set the selection mode to multiple and extended.
listBox1.SelectionMode = SelectionMode.MultiExtended
' Shutdown the painting of the ListBox as items are added.
listBox1.BeginUpdate()
' Loop through and add 50 items to the ListBox.
Dim x As Integer
For x = 1 To 50
listBox1.Items.Add("Item " & x.ToString())
Next x
' Allow the ListBox to repaint and display the new items.
listBox1.EndUpdate()
' Select three items from the ListBox.
listBox1.SetSelected(1, True)
listBox1.SetSelected(3, True)
listBox1.SetSelected(5, True)
' Display the second selected item in the ListBox to the console.
System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems(1).ToString())
' Display the index of the first selected item in the ListBox.
System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices(0).ToString())
End Sub
Hinweise
Mit dieser Eigenschaft können Sie einen Verweis auf die Liste der Elemente abrufen, die derzeit in der ListBox. Mit diesem Verweis können Sie Elemente hinzufügen, Elemente entfernen und eine Anzahl der Elemente in der Auflistung abrufen. Weitere Informationen zu den Aufgaben, die mit der Elementsammlung ausgeführt werden können, finden Sie in den Themen zur ListBox.ObjectCollection Klassenreferenz.
Sie können die Elemente eines ListBox Objekts auch mithilfe der DataSource Eigenschaft bearbeiten. Wenn Sie die DataSource Eigenschaft zum Hinzufügen von Elementen zu einer ListBoxEigenschaft verwenden, können Sie die Elemente in der ListBox Verwendung der Items Eigenschaft anzeigen, aber Sie können keine Elemente mithilfe der Methoden der ListBox.ObjectCollectionListe hinzufügen oder aus der Liste entfernen.
