Paket | fl.controls |
Klasse | public class List |
Vererbung | List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implementiert | IFocusManagerComponent |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Die List-Komponente beinhaltet Elemente, Zeilen und einen Datenprovider, die wie folgt definiert werden:
- Element: Ein ActionScript-Objekt, das in der Regel die beschreibende Eigenschaft
label
und die Eigenschaftdata
enthält, die die mit dem Element verknüpften Daten speichert. - Zeile: Eine Komponente, die zum Anzeigen eines Elements verwendet wird.
- Datenprovider: Eine Komponente, die die in der List-Komponente angezeigten Elemente bestimmt.
Standardmäßig wird von der List-Komponente die CellRenderer-Klasse zum Bereistellen der Zeilen verwendet, in denen die Listenelemente angezeigt werden. Diese Zeilen können programmgesteuert erstellt werden, indem Sie eine Unterklasse der CellRenderer-Klasse erstellen. Die CellRenderer-Klasse implementiert die ICellRenderer-Oberfläche, welche die Eigenschaften- und Methodensätze liefert, die von der List-Komponente verwendet werden, um ihre Zeilen zu bearbeiten und um Daten und Statusinformationen an die einzelnen Zeilen zu senden, wo diese angezeigt werden. Hierzu zählen auch Informationen zu Größenanpassung und Auswahl von Daten.
Die List-Komponente liefert Methoden, die als Proxy für ihren Datenprovider dienen, z. B. addItem()
und removeItem()
. Sie können diese und andere Methoden zum Bearbeiten von Daten in einem beliebigen Array verwenden, das sich im gleichen Frame wie die List-Komponente befindet, und die Änderungen dann in mehreren Ansichten veröffentlichen. Wenn eine List-Komponente keinen externen Datenprovider aufweist, wird von diesen Methoden automatisch eine Datenprovider-Instanz erstellt und mithilfe der Eigenschaft List.dataProvider
eingeblendet. Die List-Komponente gibt die einzelnen Zeilen mithilfe eines Sprite-Renderers wieder, das die ICellRenderer-Oberfläche implementiert. Verwenden Sie die Eigenschaft List.cellRenderer
, um diesen Renderer anzugeben. Sie können auch eine Array-Instanz erstellen oder von einem Server abrufen und als Datenmodell für mehrere Listen, Kombinationsfelder, Datenraster usw. verwenden.
Eigenschaft | Definiert von | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Die aktuelle Eingabehilfenimplementierung (AccessibilityImplementation) für diese InteractiveObject-Instanz. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. | DisplayObject | ||
allowMultipleSelection : Boolean
Ruft einen booleschen Wert ab, der angibt, ob mehr als ein Listenelement gleichzeitig ausgewählt werden kann. | SelectableList | ||
alpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an. | DisplayObject | ||
blendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll. | DisplayObject | ||
blendShader : Shader [Nur Schreiben]
Legt einen Shader fest, der für das Mischen von Vordergrund und Hintergrund verwendet wird. | DisplayObject | ||
buttonMode : Boolean
Legt den Schaltflächenmodus für dieses Sprite fest. | Sprite | ||
cacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Bei einem Nicht-Null-Wert definiert dieses Matrix-Objekt, wie ein Anzeigeobjekt dargestellt wird, wenn cacheAsBitmap auf „true“ gesetzt ist. | DisplayObject | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
contextMenu : NativeMenu
Gibt das diesem Objekt zugeordnete Kontextmenü an. | InteractiveObject | ||
dataProvider : DataProvider
Ruft das Datenmodell der Elementenliste ab, die angezeigt werden soll, oder legt dieses fest. | SelectableList | ||
doubleClickEnabled : Boolean
Gibt an, ob das Objekt doubleClick-Ereignisse empfängt. | InteractiveObject | ||
dropTarget : DisplayObject [schreibgeschützt]
Gibt das Anzeigeobjekt an, über das der Sprite gezogen wird oder auf dem der Sprite abgelegt wurde. | Sprite | ||
enabled : Boolean
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Komponente eine Benutzereingabe annehmen kann. | UIComponent | ||
filters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält. | DisplayObject | ||
focusEnabled : Boolean
Ruft einen booleschen Wert ab, der angibt, ob die Komponente den Fokus erhalten kann, wenn der Benutzer darauf klickt, oder legt diesen fest. | UIComponent | ||
focusManager : IFocusManager
Ruft den FocusManager-Wert ab bzw. legt den FocusManager-Wert fest, der den Fokus für diese und gleichrangige Komponenten steuert. | UIComponent | ||
focusRect : Object
Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. | InteractiveObject | ||
graphics : Graphics [schreibgeschützt]
Legt das Graphics-Objekt fest, das zu diesem Sprite gehört und für das Vektorzeichnungsbefehle zulässig sind. | Sprite | ||
height : Number [override]
Ruft die Höhe der Komponente in Pixeln ab oder legt diese fest. | UIComponent | ||
hitArea : Sprite
Gibt als Kollisionsbereich für ein Sprite ein anderes Sprite an. | Sprite | ||
horizontalLineScrollSize : Number
Ruft einen Wert ab oder legt einen Wert fest, der den Betrag angibt, um den der Inhalt beim Klicken auf einen Bildlaufpfeil vertikal verschoben wird. | BaseScrollPane | ||
horizontalPageScrollSize : Number
Ruft einen Wert ab oder legt einen Wert fest, der den Betrag in Pixel angibt, um den das Bildlauffeld beim Klicken auf die Spur der Bildlaufleiste auf der horizontalen Bildlaufleiste verschoben wird. | BaseScrollPane | ||
horizontalScrollBar : ScrollBar [schreibgeschützt]
Gibt einen Verweis auf die horizontale Bildlaufleiste zurück. | BaseScrollPane | ||
horizontalScrollPolicy : String
Ruft einen Wert ab, der den Status der horizontalen Bildlaufleiste angibt, oder legt diesen Wert fest. | BaseScrollPane | ||
horizontalScrollPosition : Number
Ruft einen Wert ab oder legt einen Wert fest, der die horizontale Position der horizontalen Bildlaufleiste im Bildlauffenster beschreibt. Die Angabe erfolgt in Pixel. | BaseScrollPane | ||
iconField : String
Ruft das Elementfeld ab bzw. legt das Elementfeld fest, das das Symbol für das Element liefert. | List | ||
iconFunction : Function
Ruft die Funktion ab bzw. legt die Funktion fest, die zum Abrufen des Symbols für das Element verwendet wird. | List | ||
labelField : String
Ruft den Namen des Felds im dataProvider-Objekt ab, der als Beschriftung für das TextInput-Feld und die Dropdown-Liste angezeigt werden soll, oder legt diesen Namen fest. | List | ||
labelFunction : Function
Ruft die Funktion ab bzw. legt die Funktion fest, die zum Abrufen der Beschriftung für das Element verwendet wird. | List | ||
length : uint [schreibgeschützt]
Die Anzahl der Elemente im Datenprovider. | SelectableList | ||
loaderInfo : LoaderInfo [schreibgeschützt]
Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört. | DisplayObject | ||
mask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert. | DisplayObject | ||
maxHorizontalScrollPosition : Number [override]
Ruft die Anzahl der Pixel ab, um die in der Liste ein Bildlauf nach rechts durchgeführt werden kann, wenn die horizontalScrollPolicy-Eigenschaft auf "ScrollPolicy.ON" eingestellt ist. | SelectableList | ||
maxVerticalScrollPosition : Number [schreibgeschützt]
Ruft die maximale vertikale Bildlaufposition des aktuellen Inhalts in Pixel ab. | BaseScrollPane | ||
metaData : Object
Bezieht das Metadatenobjekt der DisplayObject-Instanz, wenn Metadaten neben der Instanz dieses DisplayObject in der SWF-Datei durch ein PlaceObject4-Tag gespeichert wurden. | DisplayObject | ||
mouseChildren : Boolean
Bestimmt, ob die untergeordneten Elemente des Objekts maus- oder benutzereingabegerätfähig sind oder nicht. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Ruft einen Wert ab, der angibt, ob die Komponente den Fokus erhalten kann, wenn der Benutzer darauf klickt, oder legt diesen fest. | UIComponent | ||
mouseX : Number [schreibgeschützt]
Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | ||
mouseY : Number [schreibgeschützt]
Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | ||
name : String
Gibt den Instanznamen des Anzeigeobjekts an. | DisplayObject | ||
needsSoftKeyboard : Boolean
Gibt an, ob eine virtuelle Tastatur (Bildschirmtastatur) angezeigt wird, wenn diese InteractiveObject-Instanz den Fokus erhält. | InteractiveObject | ||
numChildren : int [schreibgeschützt]
Liefert die Anzahl der Objekte, die diesem Objekt untergeordnet sind. | DisplayObjectContainer | ||
opaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist. | DisplayObject | ||
parent : DisplayObjectContainer [schreibgeschützt]
Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält. | DisplayObject | ||
root : DisplayObject [schreibgeschützt]
Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert. | DisplayObject | ||
rotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an. | DisplayObject | ||
rotationX : Number
Gibt die x-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | ||
rotationY : Number
Gibt die y-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | ||
rotationZ : Number
Gibt die Drehung der z-Achse der DisplayObject-Instanz in Grad an, ausgehend von ihrer ursprünglichen Ausrichtung relativ zum übergeordneten 3D-Container. | DisplayObject | ||
rowCount : uint [override]
Ruft die Anzahl der Zeilen ab, die in der Liste zumindest teilweise sichtbar sind, oder legt diese fest. | List | ||
rowHeight : Number
Ruft die Höhe jeder Zeile in der Liste in Pixeln ab oder legt diese fest. | List | ||
scale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster. | DisplayObject | ||
scaleX : Number [override]
Multipliziert die aktuelle Breite der Komponente mit einem Skalierungsfaktor. | UIComponent | ||
scaleY : Number [override]
Multipliziert die aktuelle Höhe der Komponente mit einem Skalierungsfaktor. | UIComponent | ||
scaleZ : Number
Gibt die Tiefenskalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | ||
scrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt. | DisplayObject | ||
selectable : Boolean
Ruft einen booleschen Wert ab bzw. legt einen booleschen Wert fest, der angibt, ob die Elemente in der Liste ausgewählt werden können. | SelectableList | ||
selectedIndex : int
Ruft den Index des Elements ab, das aus einer Liste mit Einzelauswahl ausgewählt wurde, oder legt diesen fest. | SelectableList | ||
selectedIndices : Array
Ruft einen Array mit den Elementen ab, die aus einer Liste mit Mehrfachauswahl ausgewählt wurden, oder legt diesen fest. | SelectableList | ||
selectedItem : Object
Ruft das Element ab bzw. legt das Element fest, das aus einer Liste mit Einzelauswahl ausgewählt wurde. | SelectableList | ||
selectedItems : Array
Ruft einen Array mit den Elementobjekten ab, die aus einer Liste mit Mehrfachauswahl ausgewählt wurden, oder legt diesen fest. | SelectableList | ||
softKeyboard : String
Steuert das Erscheinungsbild der Bildschirmtastatur. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definiert einen Bereich, der auf dem Bildschirm sichtbar bleiben soll, wenn eine virtuelle Tastatur angezeigt wird (nicht unter iOS verfügbar). | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Steuert den Sound innerhalb dieses Sprites. | Sprite | ||
stage : Stage [schreibgeschützt]
Die Bühne des Anzeigeobjekts. | DisplayObject | ||
tabChildren : Boolean
Bestimmt, ob die dem Objekt untergeordneten Objekte per Tabulatortaste aktivierbar sind. | DisplayObjectContainer | ||
tabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. | InteractiveObject | ||
tabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [schreibgeschützt]
Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz. | DisplayObjectContainer | ||
transform : flash.geom:Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören. | DisplayObject | ||
useBitmapScrolling : Boolean
Wenn diese Eigenschaft auf „true“ gesetzt ist, wird die cacheAsBitmap-Eigenschaft für den Bildlaufinhalt auf „true“ gesetzt. Wenn sie auf „false“ gesetzt ist, wird dieser Wert deaktiviert. | BaseScrollPane | ||
useHandCursor : Boolean
Ein boolescher Wert, der angibt, ob der Handcursor angezeigt werden soll, wenn der Zeiger über ein Sprite geführt wird, in dem die buttonMode-Eigenschaft auf „true“ gesetzt ist. | Sprite | ||
verticalLineScrollSize : Number
Ruft einen Wert ab oder legt einen Wert fest, der den Betrag in Pixel angibt, um den der Inhalt beim Klicken auf einen Bildlaufpfeil vertikal verschoben wird. | BaseScrollPane | ||
verticalPageScrollSize : Number
Ruft einen Wert ab oder legt einen Wert fest, der den Betrag in Pixel angibt, um den das Bildlauffeld beim Klicken auf die Spur der Bildlaufleiste auf der vertikalen Bildlaufleiste verschoben wird. | BaseScrollPane | ||
verticalScrollBar : ScrollBar [schreibgeschützt]
Gibt einen Verweis auf die vertikale Bildlaufleiste zurück. | BaseScrollPane | ||
verticalScrollPolicy : String
Ruft einen Wert ab, der den Status der vertikalen Bildlaufleiste angibt, oder legt diesen Wert fest. | BaseScrollPane | ||
verticalScrollPosition : Number
Ruft einen Wert ab oder legt einen Wert fest, der die vertikale Position der vertikalen Bildlaufleiste im Bildlauffenster beschreibt. Die Angabe erfolgt in Pixel. | BaseScrollPane | ||
visible : Boolean [override]
Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die Komponenteninstanz sichtbar ist. | UIComponent | ||
width : Number [override]
Ruft die Breite der Komponente in Pixeln ab oder legt diese fest. | UIComponent | ||
x : Number [override]
Ruft die X-Koordinate ab, die die Position der Komponente auf der X-Achse innerhalb des übergeordneten Containers angibt. | UIComponent | ||
y : Number [override]
Ruft die Y-Koordinate ab, die die Position der Komponente auf der Y-Achse innerhalb des übergeordneten Containers angibt. | UIComponent | ||
z : Number
Gibt die z-Koordinatenposition an der z-Achse der DisplayObject-Instanz relativ zum übergeordneten 3D-Container an. | DisplayObject |
Methode | Definiert von | ||
---|---|---|---|
List()
Erstellt eine neue Instanz der List-Komponente. | List | ||
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. | DisplayObjectContainer | ||
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Fügt ein Element am Ende der Elementenliste hinzu. | SelectableList | ||
Fügt der Liste an der angegebenen Indexposition ein Element hinzu. | SelectableList | ||
Gibt an, ob aufgrund der Sicherheitseinschränkungen irgendwelche Anzeigeobjekte aus der Liste ausgeschlossen werden, die beim Aufrufen der DisplayObjectContainer.getObjectsUnderPoint()-Methode mit dem angegebenen point-Punkt zurückgegeben wird. | DisplayObjectContainer | ||
Löscht einen Stil, der auf den Renderer in der Liste festgelegt ist. | SelectableList | ||
Löscht das derzeit ausgewählte Element in der Liste und setzt die selectedIndex-Eigenschaft auf -1. | SelectableList | ||
Löscht eine Stileigenschaft aus dieser Komponenteninstanz. | UIComponent | ||
Ermittelt, ob das angegebene Anzeigeobjekt der DisplayObjectContainer-Instanz oder der Instanz selbst untergeordnet ist. | DisplayObjectContainer | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Blendet die Fokusanzeige auf dieser Komponente ein oder aus. | UIComponent | ||
Leitet einen unmittelbaren Erstellungsvorgang ein, ohne sämtliche Elemente wie bei "invalidateNow" zu entwerten. | UIComponent | ||
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert. | DisplayObject | ||
Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet. | DisplayObjectContainer | ||
Gibt das untergeordnete Anzeigeobjekt für den angegebenen Namen zurück. | DisplayObjectContainer | ||
Gibt die Indexposition einer untergeordneten DisplayObject-Instanz zurück. | DisplayObjectContainer | ||
Ruft das Objekt ab, das derzeit den Fokus hat. | UIComponent | ||
Ruft das Element an der angegebenen Indexposition ab. | SelectableList | ||
Gibt den Index des nächsten Elements in der dataProvider-Komponente zurück, in dem das erste Zeichen der Bezeichnung mit einem angegebenen Stringzeichen übereinstimmt. | SelectableList | ||
Gibt ein Array an Objekten zurück, die unter dem angegebenen Punkt liegen und dieser DisplayObjectContainer-Instanz untergeordnet sind (auch über mehrere Unterordnungsstufen hinweg). | DisplayObjectContainer | ||
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter „targetCoordinateSpace“ definierten Koordinatensystems. | DisplayObject | ||
Ruft einen Stil ab, der auf den Renderer in der Liste festgelegt ist. | SelectableList | ||
Ruft eine Stileigenschaft ab, die in der Stilkette der Komponente festgelegt ist. | UIComponent | ||
[statisch]
Ruft die Standardstilmatrix der aktuellen Komponente ab. | List | ||
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | ||
Konvertiert einen zweidimensionale Punkt von den (globalen) Bühnenkoordinaten in die dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet. | DisplayObject | ||
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet. | DisplayObject | ||
Entwertet eine Eigenschaft und erstellt die Komponente im nächsten Bild neu, sofern nicht anderweitig festgelegt. | UIComponent | ||
Macht einen bestimmten Element-Renderer ungültig. | SelectableList | ||
Macht den Renderer für das Element an der angegebenen Indexposition ungültig. | SelectableList | ||
Macht die gesamte Liste ungültig und erzwingt eine Neuzeichnung aller Elemente. | SelectableList | ||
Überprüft, ob das angegebene Element in der Liste ausgewählt ist. | SelectableList | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Ruft den ICellRenderer für ein bestimmtes Elementobjekt ab (falls vorhanden). | SelectableList | ||
[override]
Ruft den String ab, den der Renderer für das angegebene Datenobjekt auf der Grundlage der labelField- und labelFunction-Eigenschaften anzeigt. | List | ||
Konvertiert einen dreidimensionalen Punkt der dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts in einen zweidimensionalen Punkt der (globalen) Bühnenkoordinaten. | DisplayObject | ||
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten. | DisplayObject | ||
[statisch]
Führt Stile aus mehreren Klassen in einem Objekt zusammen. | UIComponent | ||
Verschiebt die Komponente innerhalb der übergeordneten Komponente an die angegebene Position. | UIComponent | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt alle Elemente aus der Liste. | SelectableList | ||
Entfernt die angegebene untergeordnete DisplayObject-Instanz aus der Child-Liste der DisplayObjectContainer-Instanz. | DisplayObjectContainer | ||
Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen Indexposition in der Child-Liste des Anzeigeobjekt-Containers. | DisplayObjectContainer | ||
Entfernt alle untergeordneten DisplayObject-Instanzen aus der Liste der untergeordneten Elemente der DisplayObjectContainer-Instanz. | DisplayObjectContainer | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Entfernt das angegebene Element aus der Liste. | SelectableList | ||
Entfernt das Element an der angegebenen Indexposition. | SelectableList | ||
Ersetzt das Element an der angegebenen Indexposition durch ein anderes Element. | SelectableList | ||
Blendet eine virtuelle Tastatur ein. | InteractiveObject | ||
[override]
Führt in der Liste einen Bildlauf zu dem Element an der angegebenen Indexposition durch. | List | ||
Führt einen Bildlauf in der Liste zu dem Element an der Position durch, die durch den aktuellen Wert der selectedIndex-Eigenschaft definiert wird. | SelectableList | ||
Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container. | DisplayObjectContainer | ||
Legt den Fokus auf diese Komponente. | UIComponent | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Legt einen Stil auf dem Renderer in der Liste fest. | SelectableList | ||
Legt eine bestimmte Breite und Höhe für die Komponente fest. | UIComponent | ||
Legt eine Stileigenschaft für diese Komponenteninstanz fest. | UIComponent | ||
Sortiert die Elemente im aktuellen Datenprovider. | SelectableList | ||
Sortiert die Elemente im aktuellen Datenprovider nach einem oder mehreren Feldern. | SelectableList | ||
Ermöglicht es Benutzern, das angegebene Sprite mit einer Ziehoperation zu verschieben. | Sprite | ||
Ermöglicht dem Benutzer das Ziehen des angegebenen Sprites auf einem berührungsempfindlichen Gerät. | Sprite | ||
Stoppt rekursiv die Ausführung von allen Movieclips, die auf diesem Objekt gerootet sind. | DisplayObjectContainer | ||
Beendet die startDrag()-Methode. | Sprite | ||
Beendet die startTouchDrag()-Methode zur Verwendung mit berührungsempfindlichen Geräten. | Sprite | ||
Kehrt die z-Reihenfolge (von vorne nach hinten) der beiden angegebenen untergeordneten Objekte um. | DisplayObjectContainer | ||
Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um. | DisplayObjectContainer | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Die Eigenschaften und das Layout des Objekts werden geprüft und aktualisiert. Das Objekt wird ggf. neu erstellt. | UIComponent | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Stile sind entweder allgemein oder mit einem bestimmten Thema verknüpft. Allgemeine Stile können mit jedem Thema verwendet werden. Stile, die mit einem bestimmten Thema verknüpft sind, können nur verwendet werden, wenn Ihre Anwendung dieses Thema verwendet.
iconField | Eigenschaft |
iconField:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft das Elementfeld ab bzw. legt das Elementfeld fest, das das Symbol für das Element liefert.
Hinweis: Die Eigenschaft iconField
wird nicht verwendet, wenn die Eigenschaft iconFunction
für eine Rückrufmethode festgelegt ist.
Der Standardwert ist "icon".
Implementierung
public function get iconField():String
public function set iconField(value:String):void
Beispiel ( Verwendung dieses Beispiels )
RedBox
vorhanden sein, bei dem "Export für ActionScript" in den Symboleigenschaften aktiviert ist.
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { iconSource:RedBox, label:"Item 1" } ); dp.addItem( { iconSource:RedBox, label:"Item 2" } ); dp.addItem( { iconSource:RedBox, label:"Item 3" } ); var list:List = new List(); list.iconField = "iconSource"; list.dataProvider = dp; addChild(list);
iconFunction | Eigenschaft |
iconFunction:Function
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft die Funktion ab bzw. legt die Funktion fest, die zum Abrufen des Symbols für das Element verwendet wird.
Hinweis: Die Eigenschaft iconField
wird nicht verwendet, wenn die Eigenschaft iconFunction
für eine Rückrufmethode festgelegt ist.
Der Standardwert ist null.
Implementierung
public function get iconFunction():Function
public function set iconFunction(value:Function):void
Beispiel ( Verwendung dieses Beispiels )
iconFunction
verwendet, um ein Symbol für eine begrenzte Anzahl von Elementen in einer Liste bereitzustellen. Damit dieses Beispiel richtig funktioniert, muss in der Bibliothek ein Symbol mit der Bezeichnung RedBox
vorhanden sein, bei dem "Export für ActionScript" in den Symboleigenschaften aktiviert ist.
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { label:"Item 1" } ); dp.addItem( { label:"Item 2" } ); dp.addItem( { label:"Item 3" } ); var list:List = new List(); list.iconFunction = determineIcon; list.dataProvider = dp; addChild(list); function determineIcon(item:Object):String { if(item.label == "Item 2") { return "RedBox"; } else { return null; } }
labelField | Eigenschaft |
labelField:String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft den Namen des Felds im dataProvider
-Objekt ab, der als Beschriftung für das TextInput-Feld und die Dropdown-Liste angezeigt werden soll, oder legt diesen Namen fest.
Standardmäßig wird von der Komponente die Eigenschaft label
der einzelnen dataProvider
-Elemente angezeigt. Wenn die dataProvider
-Elemente jedoch keine Eigenschaft label
enthalten, können Sie für die Eigenschaft labelField
festlegen, dass eine andere Eigenschaft verwendet wird.
Hinweis: Die Eigenschaft labelField
wird nicht verwendet, wenn die Eigenschaft labelFunction
für eine Rückruf-Funktion festgelegt ist.
Der Standardwert ist "label".
Implementierung
public function get labelField():String
public function set labelField(value:String):void
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
abbreviatedLabel
anstatt mit der standardmäßigen label
-Eigenschaft angezeigt:
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); dp.addItem( { abbreviatedLabel:"NY", label:"New York" } ); dp.addItem( { abbreviatedLabel:"CA", label:"California" } ); dp.addItem( { abbreviatedLabel:"WA", label:"Washington" } ); dp.addItem( { abbreviatedLabel:"CT", label:"Connecticut" } ); dp.addItem( { abbreviatedLabel:"VT", label:"Vermont" } ); var list:List = new List(); list.setSize(40,100); list.labelField = "abbreviatedLabel" list.dataProvider = dp; addChild(list);
labelFunction | Eigenschaft |
labelFunction:Function
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft die Funktion ab bzw. legt die Funktion fest, die zum Abrufen der Beschriftung für das Element verwendet wird.
Standardmäßig wird von der Komponente die Eigenschaft label
für dataProvider
-Elemente angezeigt. Einige Datensätze enthalten unter Umständen kein label
-Feld oder kein Feld, dessen Wert ohne Bearbeitung als Beschriftung verwendet werden kann. So speichert beispielsweise ein bestimmter Datensatz vollständige Namen, verwaltet diese jedoch in den Feldern lastName
und firstName
. In diesem Fall kann die Eigenschaft zum Festlegen einer Callback-Funktion verwendet werden, die die Felder lastName
und firstName
in einen anzuzeigenden vollständigen Namenszeichensatz verkettet.
Hinweis: Die Eigenschaft labelField
wird nicht verwendet, wenn die Eigenschaft labelFunction
für eine Rückruf-Funktion festgelegt ist.
Der Standardwert ist null.
Implementierung
public function get labelFunction():Function
public function set labelFunction(value:Function):void
Beispiel ( Verwendung dieses Beispiels )
labelFunction
-Eigenschaft einer Liste auf eine Funktion eingestellt, welche die Zeichenfolge für eine Anzeige in allen Zellen formatiert:
import fl.data.DataProvider; import fl.controls.List; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({name:"User A", price:0.43}); myDataProvider.addItem({name:"User B", price:0.34}); var users:List = new List(); users.dataProvider = myDataProvider; users.labelFunction = myLabelFunction; addChild(users); function myLabelFunction(item:Object):String { return item.name + " ($" + item.price.toFixed(2) + ")"; }
rowCount | Eigenschaft |
rowCount:uint
[override] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft die Anzahl der Zeilen ab, die in der Liste zumindest teilweise sichtbar sind, oder legt diese fest.
Implementierung
override public function get rowCount():uint
override public function set rowCount(value:uint):void
Beispiel ( Verwendung dieses Beispiels )
rowCount
bestimmt.
import fl.data.DataProvider; import fl.controls.List; var dp:DataProvider = new DataProvider(); var i:uint; for(i=0; i<100; i++) { dp.addItem( { label: "Item " + i } ); } var list:List = new List(); list.setSize(100,300); list.dataProvider = dp; addChild(list); trace(list.rowCount); // 15
rowCount
auf Grundlage des aktuellen Wertes eines Schiebereglers festgelegt.
import fl.controls.Slider; import fl.controls.List; import fl.data.DataProvider; import fl.events.SliderEvent; var dp:DataProvider = new DataProvider(); var i:int; for (i=0; i<8; i++) { dp.addItem({label:"Item " + i}); } var mySlider:Slider = new Slider(); mySlider.move(10, 10); mySlider.tickInterval = 1; mySlider.snapInterval = 1; mySlider.minimum = 2; mySlider.maximum = 9; mySlider.liveDragging = true; mySlider.addEventListener(SliderEvent.CHANGE, changeHandler); addChild(mySlider); var myList:List = new List(); myList.dataProvider = dp; myList.move(mySlider.x, mySlider.y + 20); myList.setSize(100, 50); addChild(myList); function changeHandler(event:SliderEvent):void { myList.rowCount = event.value; }
rowHeight | Eigenschaft |
rowHeight:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft die Höhe jeder Zeile in der Liste in Pixeln ab oder legt diese fest.
Der Standardwert ist 20.
Implementierung
public function get rowHeight():Number
public function set rowHeight(value:Number):void
List | () | Konstruktor |
public function List()
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Erstellt eine neue Instanz der List-Komponente.
getStyleDefinition | () | Methode |
public static function getStyleDefinition():Object
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft die Standardstilmatrix der aktuellen Komponente ab. Die Stilmatrix enthält den für die Komponente geeigneten Typ und hängt von dem Stil ab, der von der Komponente verwendet wird. Der Stil disabledTextFormat
enthält beispielsweise den Wert null
oder ein TextFormat-Objekt. Sie können diese Stile verwenden und setStyle()
für die aktuelle Komponente aufrufen. Mit folgendem Code wird der Standardstil disabledTextFormat
der angegebenen Komponente überschrieben:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Das standardmäßige Stilobjekt.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
itemToLabel | () | Methode |
override public function itemToLabel(item:Object):String
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Ruft den String ab, den der Renderer für das angegebene Datenobjekt auf der Grundlage der Eigenschaften labelField
und labelFunction
anzeigt.
Hinweis: Die Eigenschaft labelField
wird nicht verwendet, wenn die Eigenschaft labelFunction
für eine Rückruf-Funktion festgelegt ist.
Parameter
item:Object — Das darzustellende Objekt.
|
String — Der auf der Grundlage der Daten anzuzeigende String.
|
Beispiel ( Verwendung dieses Beispiels )
import fl.controls.List; import fl.data.DataProvider; import fl.events.ListEvent; var myDataProvider:DataProvider = new DataProvider(); myDataProvider.addItem({label:"Carrot", price:0.43}); myDataProvider.addItem({label:"Tomato", price:0.34}); myDataProvider.addItem({label:"Blueberry", price:0.72}); myDataProvider.addItem({label:"Turnip", price:0.24}); var myList:List = new List(); myList.setSize(300,80); myList.dataProvider = myDataProvider; myList.labelFunction = myLabelFunction; myList.addEventListener(ListEvent.ITEM_ROLL_OVER, announceLabel); addChild(myList); function myLabelFunction(item:Object):String { return item.label + " - Current price: ($" + item.price.toFixed(2) + ")"; } function announceLabel(e:ListEvent):void { var list:List = e.target as List; var item:Object = e.item; trace("Label: " + item.label); trace("Label displayed: " + list.itemToLabel(item)); }
scrollToIndex | () | Methode |
override public function scrollToIndex(newCaretIndex:int):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9.0.28.0, AIR 1.0 |
Führt in der Liste einen Bildlauf zu dem Element an der angegebenen Indexposition durch. Falls die Indexposition außerhalb des Bereichs ist, ändert sich die Bildlaufposition nicht.
Parameter
newCaretIndex:int — Die Indexposition, zu der der Bildlauf erfolgen soll.
|
- Fügen Sie die List-, Button- und Label-Klassen zur Bibliothek hinzu.
- Speichern Sie diesen Code unter „ListExample.as“ im gleichen Verzeichnis wie die FLA-Datei.
- Legen Sie für „DocumentClass“ in der FLA-Datei „ListExample“ fest.
package { import flash.display.Sprite public class ListExample extends Sprite { import flash.events.*; import fl.data.DataProvider; import fl.controls.List import fl.controls.Label import fl.controls.Button private var clearButton:Button; private var availableItems:List; private var selectedItemList:List; private var selectedItemsList:List; public function ListExample() { createComponents(); setupComponents(); } private function setupComponents():void { var dp:Array = new Array(); var i:uint; var count:uint = availableItems.rowCount * 2; for (i = 0; i < count; i++) { dp.push({label:"Item " + i}); } availableItems.allowMultipleSelection = true; availableItems.dataProvider = new DataProvider(dp); availableItems.addEventListener(Event.CHANGE, updateLists); clearButton.addEventListener(MouseEvent.CLICK, clearHandler); } private function clearHandler(event:MouseEvent):void { availableItems.clearSelection(); // clear data providers selectedItemList.dataProvider = new DataProvider(); selectedItemsList.dataProvider = new DataProvider(); } private function updateLists(e:Event):void { selectedItemList.dataProvider = availableItems.selectedItem ? new DataProvider([availableItems.selectedItem]) : new DataProvider(); selectedItemsList.dataProvider = new DataProvider(availableItems.selectedItems); } private function createComponents():void { clearButton = new Button(); availableItems = new List(); selectedItemList = new List(); selectedItemsList = new List(); var availableItemsLabel:Label = new Label(); var selectedItemListLabel:Label = new Label(); var selectedItemsListLabel:Label = new Label(); clearButton.move(10,142); availableItems.move(10,32); selectedItemList.move(120,32); selectedItemsList.move(230,32); availableItemsLabel.move(10,10); selectedItemListLabel.move(120,10); selectedItemsListLabel.move(230,10); clearButton.label = "Clear Selection" availableItemsLabel.text = "Available Items"; selectedItemListLabel.text = "Selected Item"; selectedItemsListLabel.text = "All Selected Items"; addChild(clearButton); addChild(availableItems); addChild(selectedItemList); addChild(selectedItemsList); addChild(availableItemsLabel); addChild(selectedItemListLabel); addChild(selectedItemsListLabel); } } }
Tue Jun 12 2018, 10:04 AM Z