LISTBOX-Element

Das LISTBOX-Element bietet Benutzern die Möglichkeit, Elemente aus einer Liste auszuwählen. Diese Elemente können angegeben werden, indem ITEM-Elemente als untere Elemente des LISTBOX-Elements verwendet werden. Wenn Sie ein Listenfeld-Steuerelement benötigen, das nur bei Bedarf angezeigt wird, verwenden Sie das POPUP-Element, das mit dem LISTBOX-Element identisch ist, mit Ausnahme des Standardwerts des popUp-Attributs, das sein Anzeigeverhalten vorschreiben soll.

Das LISTBOX-Element unterstützt die folgenden Attribute.

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

Das LISTBOX-Element unterstützt die folgenden Methoden.

Methode Beschreibung
appendItem Fügt neuen Text am Ende des Listenfeld-Steuerelements ein.
deleteAll Löscht alle Elemente aus dem Listenfeld-Steuerelement.
deleteItem Löscht das Listenfeld-Steuerelementelement am angegebenen Index.
Entlassen Blendet das Steuerelement aus.
findItem Sucht nach einer angegebenen Zeichenfolge, die mit dem Element beginnt, 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 Listenfeld-Steuerelement ab, beginnend beim Element nach dem Element mit dem angegebenen Index.
insertItem Fügt den angegebenen Text am angegebenen Index in das 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 deaktiviert es.
show Zeigt das Steuerelement an.

Hinweis

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

POPUP-Element

Referenz zur Skinprogrammierung