| Paket | spark.components.gridClasses |
| Schnittstelle | public interface IGridItemRenderer extends IDataRenderer , IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
| Umsetzer | DefaultGridItemRenderer, GridItemRenderer, UITextFieldGridItemRenderer |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Alle Eigenschaften des Renderers werden beim Ausführen der updateDisplayList()-Methode seines übergeordneten Elements festgelegt. Nach dem Festlegen der Eigenschaften wird die prepare()-Methode des Elementrenderers aufgerufen. IGridItemRenderer-Implementierungen müssen die prepare()-Methode überschreiben, damit die Eigenschaften und alle Aspekte der visuellen Elemente endgültig angepasst werden können. Normalerweise wird prepare() zum Konfigurieren der visuellen Elemente des Renderers basierend auf der data-Eigenschaft verwendet.
Sobald ein Elementrenderer nicht mehr benötigt wird, weil er entweder der internen, wiederverwendbaren „freien“ Renderer-Liste hinzugefügt oder nicht mehr benötigt wird, wird die discard()-Methode aufgerufen.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | alpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an. | IVisualElement | |
| baseline : Object
Der vertikale Abstand in Pixeln vom Ankerziel zur Grundlinienposition des Steuerelements. | ILayoutElement | |
| baselinePosition : Number [schreibgeschützt]
Die y-Koordinate der Grundlinie der ersten Textzeile der Komponente. | ILayoutElement | |
| bottom : Object
Der vertikale Abstand in Pixeln vom unteren Rand der Komponente zum unteren Rand des Ankerziels. | ILayoutElement | |
| column : GridColumn
Das GridColumn-Objekt, das die mit diesem Elementrenderer verknüpfte Spalte darstellt. | IGridItemRenderer | ||
| columnIndex : int [schreibgeschützt]
Die Spaltenindexposition der Zelle dieses Elementrenderers. | IGridItemRenderer | ||
| data : Object
Die zu rendernden oder zu bearbeitenden Daten. | IDataRenderer | |
| depth : Number
Bestimmt die Reihenfolge, in der die Elemente innerhalb von Containern gerendert werden. | IVisualElement | |
| designLayer : DesignLayer
Gibt die optionale DesignLayer-Instanz zurück, die mit diesem visuellen Element verknüpft ist. | IVisualElement | |
| down : Boolean
Diese Eigenschaft ist auf „true“ gesetzt, wenn eine von zwei Eingabeaktionen in einer Rasterzelle erfolgt: Drücken der Maustaste oder Tippen auf den Touchscreen. | IGridItemRenderer | ||
| dragging : Boolean
Enthält „true“, wenn der Elementrenderer normalerweise als Teil eines Drag & Drop-Vorgangs gezogen wird. | IGridItemRenderer | ||
| grid : Grid [schreibgeschützt]
Das mit diesem Elementrenderer verknüpfte Grid, normalerweise der Wert von column.grid. | IGridItemRenderer | ||
| hasLayoutMatrix3D : Boolean [schreibgeschützt]
Enthält „true“, wenn das Element eine 3D-Matrix hat. | ILayoutElement | |
| height : Number
Gibt die Höhe des Anzeigeobjekts in Pixeln an. | IVisualElement | |
| horizontalCenter : Object
Der horizontale Abstand in Pixeln vom Mittelpunkt der Komponente zum Mittelpunkt des Inhaltsbereichs des Ankerziels. | ILayoutElement | |
| hovered : Boolean
Enthält „true“, wenn sich der Elementrenderer unter dem Mauszeiger befindet und der selectionMode des Rasters GridSelectionMode.SINGLE_CELL oder GridSelectionMode.MULTIPLE_CELLS ist oder wenn sich der Mauszeiger in der Zeile des Elementrenderers befindet und der selectionMode des Rasters GridSelectionMode.SINGLE_ROW oder GridSelectionMode.MULTIPLE_ROWS ist. | IGridItemRenderer | ||
| includeInLayout : Boolean
Gibt an, ob diese Komponente im Layout des übergeordneten Containers enthalten ist. | ILayoutElement | |
| is3D : Boolean [schreibgeschützt]
Enthält „true“, wenn das Element in 3D vorliegt. | IVisualElement | |
| label : String
Der String, der im Elementrenderer anzuzeigen ist. | IGridItemRenderer | ||
| layoutDirection : String
Legt die gewünschte Layoutrichtung für ein Element fest: entweder LayoutDirection.LTR (von links nach rechts), LayoutDirection.RTL (von rechts nach links) oder null (vererben). | ILayoutDirectionElement | |
| left : Object
Der horizontale Abstand in Pixeln vom linken Rand der Komponente zum linken Rand des Ankerziels. | ILayoutElement | |
| owner : DisplayObjectContainer
Der Eigentümer dieses IVisualElement-Objekts. | IVisualElement | |
| parent : DisplayObjectContainer [schreibgeschützt]
Der übergeordnete Container bzw. die übergeordnete Komponente dieser Komponente. | IVisualElement | |
| percentHeight : Number
Legt die Höhe einer Komponente als Prozentsatz der Größe ihres übergeordneten Objekts fest. | ILayoutElement | |
| percentWidth : Number
Legt die Breite einer Komponente als Prozentsatz der Größe ihres übergeordneten Objekts fest. | ILayoutElement | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Definiert Anpassungen, die auf die Transformation des Objekts angewendet werden können, jedoch für das Layout des übergeordneten Objekts unsichtbar bleiben. | IVisualElement | |
| right : Object
Der horizontale Abstand in Pixeln von der rechten Kante der Komponente zur rechten Kante des Ankerziels. | ILayoutElement | |
| rowIndex : int
Die auf null basierende Indexposition der Zeile der dargestellten Zelle. | IGridItemRenderer | ||
| selected : Boolean
Enthält „true“, wenn die Zelle des Elementrenderers Teil der aktuellen Auswahl ist. | IGridItemRenderer | ||
| showsCaret : Boolean
Enthält „true“, wenn die Zelle des Elementrenderers vom Einfügezeichen angezeigt wird. | IGridItemRenderer | ||
| top : Object
Der vertikale Abstand in Pixeln vom oberen Rand der Komponente zum oberen Rand des Ankerziels. | ILayoutElement | |
| verticalCenter : Object
Der vertikale Abstand in Pixeln von der Mitte der Komponente zur Mitte des Inhaltsbereichs des Ankerziels. | ILayoutElement | |
| visible : Boolean
Steuert die Sichtbarkeit dieses visuellen Elements. | IVisualElement | |
| width : Number
Gibt die Breite des Anzeigeobjekts in Pixeln an. | IVisualElement | |
| x : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | IVisualElement | |
| y : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | IVisualElement | |
| Methode | Definiert von | ||
|---|---|---|---|
| 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. | IEventDispatcher | |
Wird von der updateDisplayList()-Methode des übergeordneten Elements des Elementrenderers aufgerufen, sobald bestimmt wurde, dass dieser Renderer nicht mehr sichtbar sein wird. | IGridItemRenderer | ||
|
Sendet ein Ereignis in den Ereignisablauf. | IEventDispatcher | |
|
Gibt die x-Koordinate der Grenzen des Elements für die angegebene Elementgröße zurück. | ILayoutElement | |
|
Gibt die y-Koordinate der Grenzen des Elements für die angegebene Elementgröße zurück. | ILayoutElement | |
|
Gibt die Layouthöhe des Elements zurück. | ILayoutElement | |
|
Gibt die Layoutbreite des Elements zurück. | ILayoutElement | |
|
Gibt die x-Koordinate zurück, die für das Zeichnen des Elements auf dem Bildschirm verwendet wird. | ILayoutElement | |
|
Gibt die y-Koordinate zurück, die für das Element beim Zeichnen auf dem Bildschirm verwendet wird. | ILayoutElement | |
|
Gibt die Transformationsmatrix zurück, die zur Berechnung des Layouts der Komponente relativ zu ihren Parallelobjekten verwendet wird. | ILayoutElement | |
|
Gibt die Layouttransformations-Matrix3D für dieses Element zurück. | ILayoutElement | |
|
Gibt die maximale Höhe des Elements zurück. | ILayoutElement | |
|
Gibt die maximale Breite des Elements zurück. | ILayoutElement | |
|
Gibt die Mindesthöhe des Elements zurück. | ILayoutElement | |
|
Gibt die Mindestbreite des Elements zurück. | ILayoutElement | |
|
Gibt die bevorzugte Höhe des Elements zurück. | ILayoutElement | |
|
Gibt die bevorzugte Breite des Elements zurück. | ILayoutElement | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | IEventDispatcher | |
|
Elemente müssen diese Methode aufrufen, wenn ihre eigene layoutDirection oder die layoutDirection des übergeordneten Elements geändert wird. | ILayoutDirectionElement | |
Wird von der updateDisplayList()-Methode des übergeordneten Elements des Elementrenderers aufgerufen, nachdem alle Eigenschaften des Renderers festgelegt wurden. | IGridItemRenderer | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | IEventDispatcher | |
|
Legt die Koordinaten fest, die für das Zeichnen des Elements auf dem Bildschirm verwendet werden. | ILayoutElement | |
|
Legt die Layoutgröße des Elements fest. | ILayoutElement | |
|
Legt die Transformationsmatrix fest, die verwendet wird, um die Layoutgröße der Komponente und die Position relativ zu den Geschwisterelementen zu berechnen. | ILayoutElement | |
|
Legt die Transformations-Matrix3D fest, die zur Berechnung der Layoutgröße und -position der Komponenete relativ zu ihren Parallelobjekten verwendet wird. | ILayoutElement | |
| transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Eine Dienstprogrammmethode zum Aktualisieren der Drehung, Skalierung und Versetzung der Transformation, während gleichzeitig ein im Koordinatenraum der Komponente selbst angegebener bestimmter Punkt im übergeordneten Koordinatenraum unverändert erhalten bleibt. | ILayoutElement | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | IEventDispatcher | |
column | Eigenschaft |
column:GridColumn| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Das GridColumn-Objekt, das die mit diesem Elementrenderer verknüpfte Spalte darstellt.
Implementierung
public function get column():GridColumn public function set column(value:GridColumn):voidcolumnIndex | Eigenschaft |
down | Eigenschaft |
down:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Diese Eigenschaft ist auf true gesetzt, wenn eine von zwei Eingabeaktionen in einer Rasterzelle erfolgt: Drücken der Maustaste oder Tippen auf den Touchscreen. Die down-Eigenschaft wird auf false zurückgesetzt, wenn die Maustaste losgelassen wird, der Benutzer den Finger vom Touchscreen nimmt oder der Mauszeiger/der Finger aus der Rasterzelle gezogen wird.
Im Gegensatz zu Renderern für Listenelemente sind nicht ausschließlich die Renderer für Rasterelemente dafür zuständig, den Down-Indikator anzuzeigen. Das Raster selbst stellt den Down-Indikator für die ausgewählte Zeile oder Zelle dar. Der Elementrenderer kann auch seine visuellen Eigenschaften ändern, um anzuzeigen, dass mit der Maus auf ihn gezeigt wird.
Implementierung
public function get down():Boolean public function set down(value:Boolean):voiddragging | Eigenschaft |
dragging:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Enthält true, wenn der Elementrenderer normalerweise als Teil eines Drag & Drop-Vorgangs gezogen wird. Zurzeit wird die Drag & Drop-Funktion nicht vom Spark-DataGrid-Steuerelement unterstützt.
Implementierung
public function get dragging():Boolean public function set dragging(value:Boolean):voidgrid | Eigenschaft |
hovered | Eigenschaft |
hovered:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Enthält true, wenn sich der Elementrenderer unter dem Mauszeiger befindet und der selectionMode des Rasters GridSelectionMode GridSelectionMode.SINGLE_CELL oder GridSelectionMode.MULTIPLE_CELLS ist oder wenn sich der Mauszeiger in der Zeile des Elementrenderers befindet und der selectionMode des Rasters GridSelectionMode.SINGLE_ROW oder GridSelectionMode.MULTIPLE_ROWS ist.
Im Gegensatz zu Renderern für Listenelemente sind nicht ausschließlich die Renderer für Rasterelemente dafür zuständig, etwas anzuzeigen, um darauf hinzuweisen, dass sich der Renderer oder seine Zeile unter dem Mauszeiger befindet. Das Raster selbst zeigt den hoverIndicator-Skinteil für die Zeile oder Zelle an, auf die mit der Maus gezeigt wird. Renderer für Rasterelemente können auch ihre Eigenschaften ändern, um anzuzeigen, dass mit der Maus auf sie gezeigt wird.
Implementierung
public function get hovered():Boolean public function set hovered(value:Boolean):voidlabel | Eigenschaft |
label:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Der String, der im Elementrenderer anzuzeigen ist.
Die GridItemRenderer-Klasse kopiert automatisch den Wert dieser Eigenschaft in die text-Eigenschaft ihres labelDisplay-Elements, sofern das Element festgelegt wurde. Das Grid legt label auf den Wert fest, der von der itemToLabel()-Methode der Spalte zurückgegeben wird.
Implementierung
public function get label():String public function set label(value:String):voidVerwandte API-Elemente
rowIndex | Eigenschaft |
selected | Eigenschaft |
selected:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Enthält true, wenn die Zelle des Elementrenderers Teil der aktuellen Auswahl ist.
Im Gegensatz zu Renderern für Listenelemente sind nicht ausschließlich die Renderer für Rasterelemente zuständig, um anzuzeigen, dass sie Teil der Auswahl sind. Das Raster selbst zeigt automatisch den selectionIndicator-Skinteil für die ausgewählten Zeilen oder Zellen an. Der Elementrenderer kann auch seine visuellen Eigenschaften ändern, um hervorzuheben, dass er Teil der Auswahl ist.
Implementierung
public function get selected():Boolean public function set selected(value:Boolean):voidshowsCaret | Eigenschaft |
showsCaret:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Enthält true, wenn die Zelle des Elementrenderers vom Einfügezeichen angezeigt wird.
Im Gegensatz zu Renderern für Listenelemente sind nicht ausschließlich die Renderer für Rasterelemente zuständig, etwas anzuzeigen, um darauf hinzuweisen, dass ihre Zellen oder Zeilen ein Einfügezeichen aufweisen. Das Raster selbst zeigt automatisch den caretIndicator-Skinteil für die Zeile oder Zelle mit dem Einfügezeichen an. Der Elementrenderer kann auch seine visuellen Eigenschaften ändern, um hervorzuheben, dass er die Einfügezeichen aufweist.
Implementierung
public function get showsCaret():Boolean public function set showsCaret(value:Boolean):voiddiscard | () | Methode |
public function discard(willBeRecycled:Boolean):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Wird von der updateDisplayList()-Methode des übergeordneten Elements des Elementrenderers aufgerufen, sobald bestimmt wurde, dass dieser Renderer nicht mehr sichtbar sein wird. Wenn der willBeRecycled-Parameter true ist, fügt der Eigentümer diesen Renderer seiner internen freien Liste zur Wiederverwendung hinzu. Implementierungen können mit dieser Methode alle Renderer-Eigenschaften löschen, die nicht mehr benötigt werden.
Diese Methode wird nicht direkt aufgerufen. Wird von der DataGrid-Implementierung aufgerufen.
Parameter
willBeRecycled:Boolean — true, wenn dieser Renderer der internen freien Liste des Eigentümers zur Wiederverwendung hinzugefügt wird.
|
prepare | () | Methode |
public function prepare(hasBeenRecycled:Boolean):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Wird von der updateDisplayList()-Methode des übergeordneten Elements des Elementrenderers aufgerufen, nachdem alle Eigenschaften des Renderers festgelegt wurden. Der hasBeenRecycled-Parameter ist false, wenn dieser Renderer noch nicht verwendet wurde, d. h. er wurde nicht wiederverwendet. Diese Methode wird aufgerufen, wenn ein Renderer sichtbar wird und jedes Mal, wenn er aufgrund einer Änderung einer Renderereigenschaft oder einer ausdrücklichen Anforderung erneut angezeigt wird.
Diese Methode kann zum Konfigurieren aller visuellen Elemente und Eigenschaften eines Renderers verwendet werden. Diese Methode kann effizienter sein als die Einbindung von data-Eigenschaften in die Eigenschaften visueller Elemente. Hinweis: Da die prepare-Methode oft aufgerufen wird, achten Sie darauf, dass sie effizient kodiert ist.
Die prepare()-Methode kann viele Male aufgerufen werden, bevor die discard()-Methode aufgerufen wird.
Diese Methode wird nicht direkt aufgerufen. Wird von der DataGrid-Implementierung aufgerufen.
Parameter
hasBeenRecycled:Boolean — true, wenn dieser Renderer wiederverwendet wird.
|
Tue Jun 12 2018, 10:04 AM Z