Freigeben über

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

  • Artikel

Ein Windows Forms-ListBox-Steuerelement zeigt eine Liste an, aus der der Benutzer ein 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. 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 sind, gibt der SelectedIndex Wert das ausgewählte Element wieder, das zuerst in der Liste angezeigt wird. Die SelectedItem-Eigenschaft ähnelt SelectedIndex, gibt aber das Element selbst zurück, in der Regel ein Zeichenfolgenwert. Die Count-Eigenschaft gibt die Anzahl der Elemente in der Liste an, und der Wert der Count-Eigenschaft ist immer ein wert größer als der größtmögliche SelectedIndex Wert, da SelectedIndex nullbasiert ist.

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 mithilfe der Items-Eigenschaft während der Entwurfszeit Elemente zur Liste hinzufügen.

Weitere Informationen