Übersicht über das ListBox-Steuerelement (Windows Forms)
Mit dem ListBox-Steuerelement für Windows Forms kann eine Liste angezeigt werden, aus der die Benutzer ein oder mehrere Elemente auswählen können. Wenn nicht alle Elemente gleichzeitig angezeigt werden können, wird dem ListBox-Steuerelement automatisch eine Schiebeleiste hinzugefügt. Wenn die MultiColumn-Eigenschaft auf true festgelegt ist, werden die Elemente im Listenfeld in mehreren Spalten angezeigt. Außerdem wird auch eine horizontale Schiebeleiste angezeigt. Wenn die MultiColumn-Eigenschaft auf false festgelegt ist, werden die Elemente im Listenfeld in einer Spalte angezeigt. Außerdem wird eine vertikale Schiebeleiste angezeigt. Wenn ScrollAlwaysVisible auf true festgelegt ist, wird die Schiebeleiste unabhängig von der Anzahl der Elemente immer angezeigt. Die SelectionMode-Eigenschaft bestimmt, wie viele Listenelemente gleichzeitig ausgewählt werden können.
Möglichkeiten zum Ändern des ListBox-Steuerelements
Die SelectedIndex-Eigenschaft gibt einen ganzzahligen Wert zurück, der dem ersten ausgewählten Listenelement entspricht. Sie können das ausgewählte Element programmgesteuert ändern, indem Sie den SelectedIndex-Wert im Code modifizieren. Das entsprechende Listenelement wird im Windows Form hervorgehoben. Wenn kein Element ausgewählt ist, lautet der SelectedIndex-Wert -1. Wenn das erste Element in der Liste ausgewählt ist, ist der SelectedIndex-Wert 0. Wenn mehrere Elemente ausgewählt werden, reflektiert der SelectedIndex-Wert das ausgewählte Element, das zuerst in der Liste angezeigt wird. Die SelectedItem-Eigenschaft ist mit SelectedIndex vergleichbar. Sie gibt jedoch das Element selbst zurück, normalerweise einen Zeichenfolgenwert. Die Count-Eigenschaft gibt die Anzahl der Listenelemente an. Der Wert der Count-Eigenschaft ist immer um eins größer als der größtmöglichte SelectedIndex-Wert, da SelectedIndex nullbasiert ist.
Verwenden Sie zum Hinzufügen oder zum Löschen von Elementen in einem ListBox-Steuerelement die Methoden Add, Insert, Clear oder Remove. Alternativ können Sie Listenelemente auch zur Entwurfszeit mithilfe der Items-Eigenschaft hinzufügen.
Siehe auch
Aufgaben
Referenz
Übersicht über das ComboBox-Steuerelement (Windows Forms)
Übersicht über das CheckedListBox-Steuerelement (Windows Forms)