LISTBOX-Element

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Das LISTBOX-Element bietet Benutzern die Möglichkeit, Elemente aus einer Liste auszuwählen. Diese Elemente können mithilfe von ITEM-Elementen als untergeordnete Elemente des LISTBOX-Elements angegeben werden. Wenn Sie ein Listenfeldsteuerelement benötigen, das nur bei Bedarf angezeigt wird, verwenden Sie das POPUP-Element, das mit Ausnahme des Standardwerts des popUp-Attributs, das sein Anzeigeverhalten vorgibt, identisch mit dem LISTBOX-Element ist.

Das LISTBOX-Element unterstützt die folgenden Attribute.

attribute	Beschreibung
Backgroundcolor	Gibt die Hintergrundfarbe im Listenfeldsteuerelement an oder ruft sie ab.
Grenze	Gibt einen Wert an, der angibt, ob das Listenfeldsteuerelement über einen Rahmen verfügt, oder ruft sie ab. Kann nur zur Entwurfszeit festgelegt werden.
firstVisibleItem	Gibt den Index der ersten sichtbaren Zeile im Listenfeld-Steuerelement an oder ruft sie ab.
focusItem	Gibt die Zeile an, die den Fokus enthält, oder ruft sie ab.
fontFace	Gibt die Schriftart für das Listenfeldsteuerelement an oder ruft sie ab.
Fontsize	Gibt den Schriftgrad für das Listenfeldsteuerelement an oder ruft sie ab.
Fontstyle	Gibt die Schriftart für das Listenfeldsteuerelement an oder ruft sie ab.
vordergrundColor	Gibt die Textfarbe im Listenfeldsteuerelement an oder ruft sie ab.
itemCount	Ruft die Anzahl der Elemente im Listenfeldsteuerelement ab.
Multiselect	Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob der Benutzer mehrere Zeilen auswählen kann. Kann nur zur Entwurfszeit festgelegt werden.
Popup	Gibt einen Wert an, der angibt, ob das Element ein Popup- oder Listenfeldsteuerelement darstellt.
readOnly	Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob Text schreibgeschützt ist oder vom Benutzer ausgewählt werden kann.
Selecteditem	Gibt den Index des im Listenfeldsteuerelement ausgewählten Elements an oder ruft diesen ab.
Sortiert	Gibt einen Wert an, der angibt, ob das Listenfeldsteuerelement alphabetisch sortiert ist, oder ruft er ab.

 

Das LISTBOX-Element unterstützt die folgenden Methoden.

Methode	Beschreibung
appendItem	Fügt neuen Text am Ende des Listenfeldsteuerelements ein.
deleteAll	Löscht alle Elemente aus dem Listenfeldsteuerelement.
deleteItem	Löscht das Listenfeld-Steuerelement am angegebenen Index.
Entlassen	Blendet das Steuerelement aus.
findItem	Sucht nach einer bestimmten Zeichenfolge, beginnend mit dem Element, das dem angegebenen Elementindex folgt.
Getitem	Ruft den Text für das Element mit dem angegebenen Index ab.
getNextSelectedItem	Ruft das nächste ausgewählte Element im Listenfeldsteuerelement ab, das am Element nach dem Element mit dem angegebenen Index beginnt.
insertItem	Fügt den angegebenen Text am angegebenen Index im Listenfeld-Steuerelement ein.
replaceItem	Ersetzt den Text am angegebenen Index durch den angegebenen Text.
setSelectedState	Wählt das Element mit dem angegebenen Index aus oder hebt die Auswahl auf.
show	Zeigt das Steuerelement an.

 

Hinweis

Dieses Element erfordert Windows Medienwiedergabe für Windows XP oder höher.

 

Zugehörige Themen

POPUP-Element

Referenz zur Skin-Programmierung