| Paket | spark.core |
| Schnittstelle | public interface IGraphicElement extends IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
| Umsetzer | GraphicElement |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
IGraphicElementContainer nutzen.
Ein typisches Verwendungsbeispiel ist die gemeinsame Verwendung von DisplayObject. Die Gruppenklasse, die IGraphicElementContainer implementiert, organisiert die untergeordneten IGraphicElement-Elemente in Sequenzen, die dasselbe DisplayObject gemeinsam verwenden und zeichnen. Das DisplayObject wird vom ersten Element in der Sequenz erstellt.
In einem weiteren Verwendungsbeispiel wird ein Element nicht von einem DisplayObject abgeleitet, sondern es verwaltet, erstellt und/oder vernichtet sein eigenes DisplayObject. Der IGraphicElementContainer ruft das Element auf, um das DisplayObject zu erstellen, das DisplayObject als sein untergeordnetes Element an der korrekten Indexposition aufzurufen sowie dessen Entfernen zu verarbeiten.
Normalerweise erweitern Sie die GraphicElement-Klasse, anstatt die IGraphciElement-Schnittstelle direkt zu implementieren. Die GraphicElement-Klasse stellt den Großteil der erforderlichen Funktionen bereits zur Verfügung.
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 | |
| 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 | |
| displayObject : DisplayObject [schreibgeschützt]
Das gemeinsam verwendete DisplayObject, in dem dieses IGraphicElement gezeichnet wird. | IGraphicElement | ||
| displayObjectSharingMode : String
Gibt die Verknüpfung zwischen diesem IGraphicElement und den zugehörigen Anzeigeobjekten an. | IGraphicElement | ||
| 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 | |
| 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 | |
| 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 | |
| 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 | |
Gibt „true“ zurück, wenn dieses IGraphicElement kompatibel ist und Anzeigeobjekte gemeinsam mit dem nächsten IGraphicElement in der Sequenz verwenden kann. | IGraphicElement | ||
Gibt „true“ zurück, wenn dieses IGraphicElement kompatibel ist und Anzeigeobjekte gemeinsam mit dem in der Sequenz vorausgehenden IGraphicElement verwenden kann. | IGraphicElement | ||
Erstellt ein neues DisplayObject, in dem dieses IGraphicElement gezeichnet wird. | IGraphicElement | ||
|
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 vom IGraphicElementContainer aufgerufen, wenn ein IGraphicElement zur Hostkomponente hinzugefügt bzw. daraus entfernt wird. | IGraphicElement | ||
|
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 | |
Bestimmt, ob dieses Element sich selbst im sharedDisplayObject der Sequenz zeichnen kann. | IGraphicElement | ||
| 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 | |
Wird durch den IGraphicElementContainer aufgerufen, um dieses Element in seiner displayObject-Eigenschaft neu zu zeichnen. | IGraphicElement | ||
Wird vom IGraphicElementContainer aufgerufen, um die Eigenschaften dieses Elements zu überprüfen. | IGraphicElement | ||
Wird vom IGraphicElementContainer aufgerufen, um die Größe dieses Elements zu überprüfen. | IGraphicElement | ||
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | IEventDispatcher | |
displayObject | Eigenschaft |
displayObject:DisplayObject [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Das gemeinsam verwendete DisplayObject, in dem dieses IGraphicElement gezeichnet wird.
Implementierer sollten das DisplayObject nicht an dieser Stelle erstellen, sondern in der createDisplayObject()-Methode.
Implementierung
public function get displayObject():DisplayObjectVerwandte API-Elemente
displayObjectSharingMode | Eigenschaft |
displayObjectSharingMode:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10, AIR 2.5 |
Gibt die Verknüpfung zwischen diesem IGraphicElement und den zugehörigen Anzeigeobjekten an. Der IGraphicElementContainer verwaltet diese Eigenschaft und die Werte entsprechen denen der DisplayObjectSharingMode-enum-Klasse.
- Ein Wert von
DisplayObjectSharingMode.OWNS_UNSHARED_OBJECTgibt an, dass das IGraphicElement im ausschließlichen Besitz des DisplayObject entsprechend der zugehörigendisplayObject-Eigenschaft ist. - Ein Wert von
DisplayObjectSharingMode.OWNS_SHARED_OBJECTgibt an, dass das IGraphicElement im Besitz des DisplayObject entsprechend der zugehörigendisplayObject-Eigenschaft ist, aber ein anderes IGraphicElement ebenfalls dieses Anzeigeobjekt verwendet bzw. darauf zeichnet. Je nach der entsprechenden Implementierung kann das IGraphicElement eine bestimmte Verwaltung des Anzeigeobjekts durchführen. Beispielsweise werden durch die Basisklasse GraphicElement die Transformation des Anzeigeobjekts deaktiviert, die Eigenschaften für Sichtbarkeit, Alpha usw. auf die Standardwerte zurückgesetzt und zusätzlich die Grafiken bei jedemvalidateDisplayList()-Aufruf deaktiviert. - Ein Wert von
DisplayObjectSharingMode.USES_SHARED_OBJECTgibt an, dass das IGraphicElement in dem DisplayObject zeichnet, das der zugehörigendisplayObject-Eigenschaft entspricht. Es gibt weitere IGraphicElements, die im gleichen displayObject zeichnen. Bei dem ersten Element, das einen Zeichenvorgang durchführt, ist der Modus aufDisplayObjectMode.OWNS_SHARED_OBJECTgesetzt.
Implementierung
public function get displayObjectSharingMode():String public function set displayObjectSharingMode(value:String):voidcanShareWithNext | () | Methode |
public function canShareWithNext(element:IGraphicElement):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt true zurück, wenn dieses IGraphicElement kompatibel ist und Anzeigeobjekte gemeinsam mit dem nächsten IGraphicElement in der Sequenz verwenden kann.
Parameter
element:IGraphicElement — Das Element, das in der Sequenz auf dieses Element folgt.
|
Boolean — Gibt true zurück, wenn dieses Element mit dem vorherigen Element in der Sequenz kompatibel ist.
|
Verwandte API-Elemente
canShareWithPrevious | () | Methode |
public function canShareWithPrevious(element:IGraphicElement):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt true zurück, wenn dieses IGraphicElement kompatibel ist und Anzeigeobjekte gemeinsam mit dem in der Sequenz vorausgehenden IGraphicElement verwenden kann.
In bestimmten Fällen wird das Element möglicherweise an den IGraphicElementContainer bei einem Aufruf der setSharedDisplayObject()-Methode übergeben. In diesen Fällen wird diese Methode nicht aufgerufen.
Parameter
element:IGraphicElement — Das Element, das sich in der Sequenz vor diesem Element befindet.
|
Boolean — Gibt true zurück, wenn dieses Element mit dem vorherigen Element in der Sequenz kompatibel ist.
|
Verwandte API-Elemente
createDisplayObject | () | Methode |
public function createDisplayObject():DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Erstellt ein neues DisplayObject, in dem dieses IGraphicElement gezeichnet wird.
Nachfolgende Aufrufe der get-Methode für die displayObject-Eigenschaft müssen dasselbe Anzeigeobjekt zurückgeben.
Nachdem das DisplayObject erstellt wurde, wird der übergeordnete IGraphicElementContainer über die Anzeigeobjekte an den Rest der Elemente in der Sequenz übergeben.
Der IGraphicElementContainer stellt sicher, dass diese Methode nur aufgerufen wird, wenn erforderlich.
Wenn das Element an der gemeinsamen Verwendung von DisplayObject beteiligt werden möchte, muss das neue DisplayObject das IShareableDisplayObject implementieren. Diese Schnittstelle wird vom IGraphicElementContainer verwendet, um das Ungültigmachen und Neuzeichnen der grafischen Elementsequenz zu verwalten. Sie wird vom Entwickler nicht direkt verwendet.
Um die gemeinsam genutzten Sequenzen erneut auszuwerten, rufen Sie die invalidateGraphicElementSharing()-Methode im IGraphicElementContainer auf.
Damit der IGraphicElementContainer das aktuelle DisplayObject des Elements aus der Anzeigeliste entfernt und die gemeinsame Verwendung der Anzeigeobjekte neu berechnet, rufen Sie die discardDisplayObject()-Methode im IGraphicElementContainer auf.
DisplayObject — Das DisplayObject wird erstellt..
|
Verwandte API-Elemente
parentChanged | () | Methode |
public function parentChanged(parent:IGraphicElementContainer):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird vom IGraphicElementContainer aufgerufen, wenn ein IGraphicElement zur Hostkomponente hinzugefügt bzw. daraus entfernt wird.
Unter normalen Umständen brauchen Sie diese Methode nie aufzurufen.
Parameter
parent:IGraphicElementContainer — Der IGraphicElementContainer dieses IGraphicElement.
|
setSharedDisplayObject | () | Methode |
public function setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Bestimmt, ob dieses Element sich selbst im sharedDisplayObject der Sequenz zeichnen kann.
Implementierer geben normalerweise true zurück, wenn dieses IGraphicElement sich kumulativ in die graphics-Eigenschaft des gemeinsam verwendeten DisplayObject zeichnen kann. In allen Fällen, in denen IGraphicElement Eigenschaften für DisplayObjects einstellen muss, die nicht auf den Rest der Elemente in der Sequenz angewendet werden, muss diese Methode false zurückgeben. Beispiele für derartige Eigenschaften sind „rotation“, „scale“, „transform“, „mask“, „alpha“, „filters“, „color transform“, „3D“ und „layer“.
Wenn diese Methode true zurückgibt, müssen nachfolgende Aufrufe der get-Methode für die displayObject-Eigenschaft dasselbe Anzeigeobjekt zurückgeben.
In bestimmten Fällen kann die sharedDisplayObject-Eigenschaft der IGraphicElementContainer sein. In allen anderen Fällen wird das DisplayObject durch das erste Element in der Sequenz erstellt.
Wenn dieses IGraphicElement die zugehörige Sequenz erneut erstellen muss, benachrichtigt es den IGraphicElementContainer durch Aufrufen der zugehörigen invalidateGraphicElementSharing()-Methode.
Parameter
sharedDisplayObject:DisplayObject — Das gemeinsam verwendete DisplayObject.
|
Boolean — Gibt true zurück, wenn dieses IGraphicElement sich selbst im gemeinsam verwendeten DisplayObject der Sequenz zeichnen kann.
|
Verwandte API-Elemente
validateDisplayList | () | Methode |
public function validateDisplayList():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird durch den IGraphicElementContainer aufgerufen, um dieses Element in seiner displayObject-Eigenschaft neu zu zeichnen.
Wenn es sich um das erste Element in der Sequenz handelt (displayObjectSharingMode ist auf DisplayObjectSharingMode.OWNS_SHARED_OBJECT gesetzt), muss die displayObject-Grafik deaktiviert und wie erforderlich zum Zeichnen der restlichen Elemente eingerichtet werden.
Das Element muss immer neu gezeichnet werden, selbst wenn es sich seit dem letzten Aufruf der validateDisplayList()-Methode nicht verändert hat. Der übergeordnete IGraphicElementContainer zeichnet die gesamte Sequenz neu, wenn auch nur eines der Elemente neu gezeichnet werden muss.
Um sicherzustellen, dass diese Methode aufgerufen wurde, benachrichtigen Sie den IGraphicElementContainer durch Aufrufen der zugehörigen invalidateGraphicElementSize()-Methode.
Diese Methode kann selbst dann aufgerufen werden, wenn dieses Element den IGraphicElementContainer nicht benachrichtigt hat.
Verwandte API-Elemente
validateProperties | () | Methode |
public function validateProperties():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird vom IGraphicElementContainer aufgerufen, um die Eigenschaften dieses Elements zu überprüfen.
Um sicherzustellen, dass diese Methode aufgerufen wird, benachrichtigen Sie den IGraphicElementContainer durch Aufrufen der zugehörigen invalidateGraphicElementProperties()-Methode.
Diese Methode kann selbst dann aufgerufen werden, wenn dieses Element den IGraphicElementContainer nicht benachrichtigt hat.
Verwandte API-Elemente
validateSize | () | Methode |
public function validateSize():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird vom IGraphicElementContainer aufgerufen, um die Größe dieses Elements zu überprüfen.
Wenn sich die Größe des Elements ändert und sich diese Änderung auf das Layout des IGraphicElementContainer auswirkt, ist der Implementierer für das Ungültigmachen der Größe des übergeordneten Elements und der Anzeigeleiste zuständig.
Um sicherzustellen, dass diese Methode aufgerufen wird, benachrichtigen Sie den IGraphicElementContainer durch Aufrufen der zugehörigen invalidateGraphicElementSize()-Methode.
Diese Methode kann selbst dann aufgerufen werden, wenn dieses Element den IGraphicElementContainer nicht benachrichtigt hat.
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z