FListBox (Komponente)
Mit der FListBox-Komponente lassen sich in der Flash-Authoring-Umgebung per Drag-and-Drop scrollbare Listenfelder für die Auswahl von einem oder mehreren Elementen zu Flash-Dokumenten hinzufügen. Diese Komponente bietet auch eine Benutzeroberfläche zur Einstellung der Grundparameter. Die Methoden der FListBox-Komponente ermöglichen die Steuerung von Listenfeldern zur Laufzeit: Sie können Listenfelder erstellen, in der Authoring-Umgebung erstellte Listenfelder steuern, Grundparameter einstellen oder überschreiben und zusätzliche Laufzeitoptionen festlegen. Zum Zugriff auf die Komponentenmethoden ist kein Konstruktor erforderlich.
Im Gegensatz zu anderen nativen ActionScript-Objekten und -Aktionen führen Komponentenmethoden keine typenspezifische Fehlerprüfung durch. Aus diesem Grund wird empfohlen, Parameter vor der Übergabe an Methoden zu überprüfen.
Das FListBox-Objekt wird vom Flash Player 6 und späteren Versionen unterstützt.
Weitere Informationen zur Benutzung der FListBox-Komponente, zur Einstellung von Parametern beim Authoring und zur Änderung der Farbe und des Aussehens von Komponenten finden Sie unter Farben und Text von Komponenten anpassen und Komponenten-Skins anpassen im Kapitel Mit Komponenten arbeiten des Handbuchs Flash verwenden.
Methodenübersicht für die FListBox-Komponente
Methode - Beschreibung
FListBox.addItem - Fügt ein neues Element am Ende des Listenfelds hinzu.
FListBox.addItemAt - Fügt ein neues Element an der angegebenen Indexposition im Listenfeld hinzu.
FListBox.getEnabled - Gibt true zurück, wenn das Listenfeld aktiviert ist, und false, wenn es deaktiviert ist.
FListBox.getItemAt - Gibt die Bezeichnung und den Wert des Elements an der angegebenen Indexposition zurück.
FListBox.getLength - Gibt die Anzahl von Elementen im Listenfeld zurück.
FListBox.getRowCount - Gibt die Anzahl sichtbarer Elemente im Listenfeld zurück.
FListBox.getScrollPosition - Gibt die Indexposition des Elements am Anfang des Listenfelds zurück.
FListBox.getSelectedIndex - Gibt die Indexposition des letzten ausgewählten Elements zurück.
FListBox.getSelectedIndices - Gibt die Indexpositionen mehrerer ausgewählter Elemente zurück.
FListBox.getSelectedItem - Gibt die Bezeichnung und den Wert des ausgewählten Elements zurück.
FListBox.getSelectedItems - Gibt die Bezeichnung und den Wert mehrerer ausgewählter Elemente zurück.
FListBox.getSelectMultiple - Gibt true zurück, wenn mehrere Elemente ausgewählt werden können, und false, wenn nur ein Element auswählbar ist.
FListBox.getValue - Gibt die Bezeichnung des ausgewählten Elements bzw. mit dem Element verknüpfte Daten zurück.
FListBox.registerSkinElement - Weist ein Skin-Element einer Eigenschaft zu.
FListBox.removeAll - Entfernt alle Elemente aus dem Listenfeld.
FListBox.removeItemAt - Entfernt das Element an der angegebenen Indexposition.
FListBox.replaceItemAt - Ersetzt die Bezeichnung und Daten eines Elements an der angegebenen Indexposition durch eine neue Bezeichnung und neue Daten.
FListBox.setAutoHideScrollBar - Bestimmt, ob eine Bildlaufleiste unsichtbar (true) oder sichtbar ist (false), wenn alle Elemente im Listenfeld ohne Bildlauf angezeigt werden können.
FListBox.setChangeHandler - Weist eine Funktion zu, die jedesmal dann aufgerufen wird, wenn sich die Auswahl ändert.
FListBox.setDataProvider - Verknüpft ein externes Objekt mit dem Listenfeld.
FListBox.setEnabled - Gibt an, ob das Listenfeld aktiviert (true) oder deaktiviert ist (false).
FListBox.setItemSymbol - Weist eine Symbolverknüpfungs-ID zum Anzeigen von Elementen im Listenfeld zu.
FListBox.setRowCount - Bestimmt, wie viele Elemente im Listenfeld angezeigt werden.
FListBox.setScrollPosition - Führt zu einem Bildlauf im Listenfeld, der bewirkt, dass das Element mit dem angegebenen Indexwert am Anfang der Liste erscheint.
FListBox.setSelectedIndex - Wählt das Element an der angegebenen Indexposition aus und aktualisiert das Listenfeld.
FListBox.setSelectedIndices - Wählt die Elemente an den angegebenen Indexpositionen aus und aktualisiert das Listenfeld.
FListBox.setSelectMultiple - Bestimmt, ob der Benutzer mehrere Elemente in der Liste auswählen kann (true) oder nicht (false).
FListBox.setSize - Stellt die Höhe und Breite des Listenfelds in Pixel ein.
FListBox.setStyleProperty - Stellt eine einzelne Stileigenschaft für eine Komponente ein.
FListBox.setWidth - Stellt die Breite des Listenfelds in Pixel ein.
FListBox.sortItemsBy - Sortiert die Elemente im Listenfeld alphabetisch oder numerisch nach der Bezeichnung oder nach den Daten.
