Übersicht über das ListBox-Steuerelement (Windows Forms)
Aktualisiert: November 2007
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 Bildlaufleiste 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 Bildlaufleiste angezeigt. Wenn die MultiColumn-Eigenschaft auf false festgelegt ist, werden die Elemente im Listenfeld in einer Spalte angezeigt. Außerdem wird eine vertikale Bildlaufleiste angezeigt. Wenn ScrollAlwaysVisible auf true festgelegt ist, wird die Bildlaufleiste 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. Wurde kein Element ausgewählt, beträgt der SelectedIndex-Wert -1. Wenn das erste Listenelement ausgewählt ist, beträgt der SelectedIndex-Wert 0. Wenn mehrere Elemente ausgewählt sind, entspricht der SelectedIndex-Wert dem ausgewählten Element, das zuoberst 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)