Freigeben über

Übersicht über das ListBox-Steuerelement (Windows Forms)

  • Artikel

Ein ListBox-Steuerelement von Windows Forms zeigt eine Liste an, aus der der Benutzer eines oder mehrere Elemente auswählen kann. Wenn die Gesamtzahl der Elemente die anzeigbare Anzahl übersteigt, wird dem ListBox-Steuerelement automatisch eine Scrollleiste hinzugefügt. Wenn die MultiColumn-Eigenschaft auf true festgelegt ist, zeigt das Listenfeld Elemente in mehreren Spalten an und es wird eine horizontale Scrollleiste eingeblendet. Wenn die MultiColumn-Eigenschaft auf false festgelegt ist, zeigt das Listenfeld die Elemente in einer einzelnen Spalte an und es wird eine vertikale Scrollleiste eingeblendet. Wenn ScrollAlwaysVisible auf true festgelegt ist, wird die Scrollleiste unabhängig von der Anzahl der Elemente 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 Element im Listenfeld entspricht. Sie können das ausgewählte Element programmgesteuert ändern, indem Sie den SelectedIndex-Wert im Code ändern. Das entsprechende Element in der Liste wird im Windows-Formular hervorgehoben angezeigt. Wenn kein Element ausgewählt ist, ist der Wert von SelectedIndex -1. Wenn das erste Element in der Liste ausgewählt ist, ist der Wert von SelectedIndex 0. Wenn mehrere Elemente ausgewählt sind, gibt der Wert SelectedIndex das ausgewählte Element an, das als erstes in der Liste angezeigt wird. Die SelectedItem-Eigenschaft ähnelt SelectedIndex, gibt aber das Element selbst zurück, normalerweise eine Zeichenfolge. Die Count-Eigenschaft gibt die Anzahl der Elemente in der Liste wieder. Der Wert der Count-Eigenschaft ist stets um 1 höher als der größtmögliche Wert von SelectedIndex, da SelectedIndex auf 0 basiert.

Um Elemente in einem ListBox-Steuerelement hinzuzufügen oder zu löschen, verwenden Sie die Methode Add, Insert, Clear oder Remove. Alternativ können Sie der Liste auch Elemente hinzufügen, indem Sie die Items-Eigenschaft zur Entwurfszeit verwenden.

Weitere Informationen