GraphicElement  - AS3 Flex

Die Transparenzstufe des Grafikelements. Die zulässigen Werte sind Dezimalwerte zwischen 0 (völlig transparent) und 1 (völlig undurchsichtig). Beispiel: Der Wert .25 bedeutet, dass das Element über eine Deckkraft von 25 % verfügt.

Gibt an, dass dieses GraphicElement mit einem eigenen DisplayObject verknüpft werden und mit diesem dargestellt werden soll.

Der Standardwert ist false.

Der vertikale Abstand in Pixeln vom Ankerziel zur Grundlinienposition des Steuerelements.

Standardmäßig entspricht das Ankerziel dem oberen Rand des Inhaltsbereichs im Container. In Layouts mit erweiterten Beschränkungen kann das Ziel eine Beschränkungszeile sein.

Mit dem Einstellen der Eigenschaft auf eine Zahl oder einen numerischen String wie „10“ wird die Verwendung des standardmäßigen Ankerziels festgelegt.

Um ein Ankerziel anzugeben, stellen Sie den Eigenschaftswert auf einen String im Format „anchorTargetName:value“ ein. Beispiel: „row1:10“.

Die y-Koordinate der Grundlinie der ersten Textzeile der Komponente.

Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welche Füllmethode verwendet werden soll.

Der Standardwert ist auto.

Verwandte API-Elemente

Der vertikale Abstand in Pixeln vom unteren Rand der Komponente zum unteren Rand des Ankerziels.

Standardmäßig entspricht das Ankerziel dem Inhaltsbereich des Containers. In Layouts mit erweiterten Beschränkungen kann das Ziel eine Beschränkungszeile sein.

Mit dem Einstellen der Eigenschaft auf eine Zahl oder einen numerischen String wie „10“ wird die Verwendung des standardmäßigen Ankerziels festgelegt.

Um ein Ankerziel anzugeben, stellen Sie den Eigenschaftswert auf einen String im Format „anchorTargetName:value“ ein. Beispiel: „row1:10“.

Legt die Reihenfolge zum Rendern von Elementen in Containern fest. In Spark-Containern werden Elemente auf der Basis ihrer depth-Eigenschaft angeordnet. Die unterste Tiefe befindet sich hinten, die darüber liegenden Tiefen davor. Elemente mit demselben Tiefenwert werden in der Reihenfolge angezeigt, in der sie dem Container hinzugefügt werden.

Gibt die optionale DesignLayer-Instanz zurück, die mit diesem visuellen Element verknüpft ist.

Wenn ein DesignLayer zugewiesen wird, müssen visuelle Elemente Sichtbarkeit und Alpha ihrer übergeordneten Ebene berücksichtigen, wenn sie ihre eigenen Werte für effektive Sichtbarkeit oder Alpha an ihr Basis-DisplayObject übergeben (sofern zutreffend).

Visuelle Elemente müssen auf layerPropertyChange-Benachrichtigungen von der verknüpften übergeordneten Ebene warten. Wenn sich effectiveAlpha oder effectiveVisibility der Ebene ändern, muss das entsprechende Element seine eigene effektive Sichtbarkeit (oder sein Alpha) berechnen und entsprechend anwenden.

Legen Sie diese Eigenschaft in MXML nicht direkt fest.

Die designLayer-Eigenschaft wird nicht zur z-Reihenfolgesteuerung verwendet. Weitere Informationen finden Sie unter depth.

Das gemeinsam verwendete DisplayObject, in dem dieses IGraphicElement gezeichnet wird.

Implementierer sollten das DisplayObject nicht an dieser Stelle erstellen, sondern in der createDisplayObject()-Methode.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

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_OBJECT gibt an, dass das IGraphicElement im ausschließlichen Besitz des DisplayObject entsprechend der zugehörigen displayObject-Eigenschaft ist.
• Ein Wert von DisplayObjectSharingMode.OWNS_SHARED_OBJECT gibt an, dass das IGraphicElement im Besitz des DisplayObject entsprechend der zugehörigen displayObject-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 jedem validateDisplayList()-Aufruf deaktiviert.
• Ein Wert von DisplayObjectSharingMode.USES_SHARED_OBJECT gibt an, dass das IGraphicElement in dem DisplayObject zeichnet, das der zugehörigen displayObject-Eigenschaft entspricht. Es gibt weitere IGraphicElements, die im gleichen displayObject zeichnen. Bei dem ersten Element, das einen Zeichenvorgang durchführt, ist der Modus auf DisplayObjectMode.OWNS_SHARED_OBJECT gesetzt.

Das tatsächliche DisplayObject, in das vom GraphicElement gezeichnet wird. Dies entspricht gewöhnlich der displayObject-Eigenschaft. Unterklassen sollten Zeichenbefehle bei dieser Eigenschaft ausführen, statt bei displayObject.

Die x-Position, an der das Element gezeichnet werden sollte.

Die y-Position, an der das Element gezeichnet werden sollte.

Eine Zahl, die die explizite Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt.

Verwandte API-Elemente

Die empfohlene maximale Höhe der Komponente, die vom übergeordneten Element während der Layouterstellung berücksichtigt wird. Dieser Wert wird in den Koordinaten der Komponente in Pixeln angegeben.

Verwandte API-Elemente

Die empfohlene maximale Breite der Komponente, die vom übergeordneten Element während der Layouterstellung berücksichtigt wird. Dieser Wert wird in den Koordinaten der Komponente in Pixeln angegeben.

Verwandte API-Elemente

Die empfohlene Mindesthöhe der Komponente, die vom übergeordneten Element während der Layouterstellung berücksichtigt wird. Dieser Wert wird in den Koordinaten der Komponente in Pixeln angegeben.

Verwandte API-Elemente

Die empfohlene Mindestbreite der Komponente, die vom übergeordneten Element während der Layouterstellung berücksichtigt wird. Dieser Wert wird in den Koordinaten der Komponente in Pixeln angegeben.

Verwandte API-Elemente

Eine Zahl, die die explizite Breite der Komponente in Pixeln als Koordinaten der Komponente angibt.

Verwandte API-Elemente

Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält. Die Klassen im mx.filters-Paket definieren spezifische Filter, die Sie verwenden können.

Die Get-Funktion gibt eine Kopie des Filterarrays zurück. Der Wert der filters-Eigenschaft kann nur über die Set-Funktion geändert werden.

Verwandte API-Elemente

Gibt „true“ zurück, wenn das GraphicElement über keine Transformationseigenschaften mit Versetzung (x,y) verfügt.

Enthält true, wenn das Element eine 3D-Matrix hat.

Verwenden Sie hasLayoutMatrix3D, anstatt den Rückgabewert von getLayoutMatrix3D() aufzurufen und zu prüfen, da diese Methode auch dann eine gültige Matrix zurückgibt, wenn es sich um ein 2D-Element handelt.

Die Höhe des Grafikelements.

Der Standardwert ist 0.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

Der horizontale Abstand in Pixeln vom Mittelpunkt der Komponente zum Mittelpunkt des Inhaltsbereichs des Ankerziels.

Das standardmäßige Ankerziel ist der Container selbst.

In Layouts mit erweiterten Beschränkungen kann das Ankerziel eine Beschränkungsspalte sein. Dann entspricht der Inhaltsbereich dem Raum zwischen der vorherigen Spalte (oder Containerseite) und der Zielspalte.

Mit dem Einstellen der Eigenschaft auf eine Zahl oder einen numerischen String wie „10“ wird die Verwendung des standardmäßigen Ankerziels festgelegt.

Um ein Ankerziel anzugeben, stellen Sie den Eigenschaftswert auf einen String im Format „constraintColumnId:value“ ein. Beispiel: „col1:10“.

Die Identität der Komponente.

Gibt an, ob dieses Element in das Layout des übergeordneten Elements eingeschlossen ist.

Der Standardwert ist true.

Enthält true, wenn das Element in 3D vorliegt. Das Element kann in 3D vorliegen, weil es entweder 3D-Transformationseigenschaften hat oder 3D-Transformationsoffsets nach dem Layout oder beides.

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). Diese Eigenschaft wird in der Regel durch einen vererbenden Stil unterstützt. Bei null wird der layoutDirection-Stil als undefiniert festgelegt. Klassen wie GraphicElement, die ILayoutDirectionElement implementieren, aber Stile nicht unterstützen, müssen zusätzlich einen Nullwert für diese Eigenschaft unterstützen. Das heißt, dass die layoutDirection vom übergeordneten Element vererbt werden muss.

Enthält alle Implementierungsdetails in Bezug darauf, wie das GraphicElement die Transformation und die Layering-Unterstützung implementiert In den meisten Fällen müssen Sie diese Eigenschaft nicht ändern.

Der horizontale Abstand in Pixeln vom linken Rand der Komponente zum linken Rand des Ankerziels.

Standardmäßig entspricht das Ankerziel dem Inhaltsbereich des Containers. In Layouts mit erweiterten Beschränkungen kann das Ziel eine Beschränkungsspalte sein.

Mit dem Einstellen der Eigenschaft auf eine Zahl oder einen numerischen String wie „10“ wird die Verwendung des standardmäßigen Ankerziels festgelegt.

Um ein Ankerziel anzugeben, stellen Sie den Eigenschaftswert auf einen String im Format „anchorTargetName:value“ ein. Beispiel: „col1:10“.

Eine Eigenschaft, die steuert, ob die Luminanzmaske den maskierten Inhalt beschneidet. Diese Eigenschaft kann sich nur auswirken, wenn auf das Grafikelement eine Maske des Typs MaskType.LUMINOSITY angewendet wird.

Der Standardwert ist false.

Verwandte API-Elemente

Eine Eigenschaft, die die Berechnung des RGB-Farbwerts eines Grafikelements, das durch eine Luminanzmaske maskiert wird, steuert. Bei „true“ wird der RGB-Farbwert der Pixel des Quellinhalts umgekehrt und mit dem entsprechenden Bereich der Maske multipliziert. Bei „false“ wird der RGB-Farbwert der Pixel des Quellinhalts direkt verwendet.

Der Standardwert ist false.

Verwandte API-Elemente

Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert. Wenn sich das mask-Anzeigeobjekt nicht auf der Anzeigeliste befindet, wird es ihr als untergeordnetes Objekt des displayObject hinzugefügt. Das mask-Objekt selbst wird nicht gezeichnet. Setzen Sie mask auf null, um die Maske zu entfernen. Um ein anderes GraphicElement als Maske zu verwenden, schließen Sie das GraphicElement in eine Gruppe oder einen anderen Container ein.

Verwandte API-Elemente

Definiert, wie die Maske auf das GraphicElement angewendet wird.

Mögliche Werte sind MaskType.CLIP, MaskType.ALPHA und MaskType.LUMINOSITY.

Schnittmasken

Beim Maskieren im Schnittmodus wird die Schnittmaske auf 1 Bit reduziert. Das bedeutet, dass die Maske die Deckkraft eines Pixels des Quellinhalts nicht beeinflusst. Entweder bleibt der Wert unverändert, wenn das entsprechende Pixel der Maske einen Alphawert ungleich null hat, oder es wird voll transparent, wenn der Wert des Maskenpixels einen Alphawert von null hat.

Wenn Sie Schnittmasken verwenden, werden nur die tatsächlichen, durch die Maske definierten Pfad- und Formvektoren sowie Füllungen verwendet, um die Auswirkung auf den Quellinhalt zu bestimmen. Striche und Bitmapfilter, die für die Maske definiert wurden, werden ignoriert. Jeder in der Maske gefüllte Bereich gilt als gefüllt und gibt den Quellinhalt wieder. Typ und Parameter der Füllung sind nicht relevant. Eine durchgehende Farbfüllung, Verlaufsfläche oder Bitmapfüllung einer Maske gibt stets den darunter liegenden Quellinhalt wieder, unabhängig von den Alphawerten der Maskenfüllung.

BitmapGraphics werden bei Verwendung in einer Schnittmaske als mit einer Bitmap gefüllte Rechtecke betrachtet. Folglich ist der Alphakanal der Quellbitmap nicht relevant, wenn er Teil einer Maske ist. Die Bitmap wirkt sich auf die Maske genauso aus wie ein Rechteck mit durchgehende Farbfüllung entsprechender Abmessungen.

Alphamasken

Im Alphamodus wird die Deckkraft eines jeden Pixels des Quellinhalts mit der Deckkraft des entsprechenden Bereichs der Maske multipliziert. D. h., ein Pixel des Quellinhalts mit einer Deckkraft von 1, das mit einem Bereich mit der Deckkraft 5 maskiert ist, hat im Ergebnis eine Deckkraft von 5. Ein Quellpixel mit einer Deckkraft von 0,8, das mit einem Bereich mit der Deckkraft 0,5 maskiert ist, hat im Ergebnis eine Deckkraft von 0,4.

Konzeptionell entspricht die Verwendung von Alphamasken der Wiedergabe des transformierten Masken- und Quellinhalts auf separaten RGBA-Oberflächen und der Multiplikation des Alphakanals des Maskeninhalts in den Alphakanal des Quellinhalts. Der gesamte Maskeninhalt wird auf der Oberfläche wiedergegeben, bevor er auf der Oberfläche des Quellinhalts zusammengesetzt wird. Dies führt dazu, dass alle FXG-Merkmale wie Striche, Bitmapfilter und Füllungsdeckkraft sich auf den endgültigen zusammengesetzten Inhalt auswirken.

Im Alphamodus wird der Alphakanal der Bitmapdaten wie üblich im Alphakanal der Maske berücksichtigt und wirkt sich auf den am Ende wiedergegebenen Inhalt aus. Dies gilt sowohl für BitmapGraphics als auch für Bitmap-gefüllte Formen und Pfade.

Luminanzmasken

Eine Luminanzmaske, manchmal digitale Maske genannt, funktioniert ganz ähnlich wie eine Alphamaske, außer dass sowohl die Deckkraft als auch der RGB-Farbwert der Pixel des Quellinhalts mit der Deckkraft und dem RGB-Farbwert des entsprechenden Bereichs der Maske multipliziert wird.

Konzeptionell entspricht die Verwendung von Luminanzmasken der Wiedergabe des transformierten Masken- und Quellinhalts auf separaten RGBA-Oberflächen und der Multiplikation des Alphakanals und des RGB-Farbwerts des Maskeninhalts in den Alphakanal und RGB-Farbwert des Quellinhalts. Der gesamte Maskeninhalt wird auf der Oberfläche wiedergegeben, bevor er auf der Oberfläche des Quellinhalts zusammengesetzt wird. Dies führt dazu, dass alle FXG-Merkmale wie Striche, Bitmapfilter und Füllungsdeckkraft sich auf den endgültigen zusammengesetzten Inhalt auswirken.

Luminanzmasken stehen nicht originär in Flash zur Verfügung, sondern in Tools wie Adobe Illustrator und Adobe Photoshop. Um bei Inhalten, die in Flash wiedergegeben werden, die visuelle Wirkung einer Luminanzmaske zu erzielen, instanziieren Grafikelemente, die eine Luminanzmaske angeben, einen Shaderfilter, der das Aussehen einer Luminanzmaske in Adobe Creative Suite-Tools imitiert.

Von Luminanzmasken maskierte Objekte können Eigenschaften zur Steuerung der RGB-Farbwerte und der Beschneidung der Maske festlegen. Weitere Informationen finden Sie bei den Attributen luminosityInvert und luminosityClip.

Der Standardwert ist MaskType.CLIP.

Verwandte API-Elemente

Die empfohlene maximale Höhe der Komponente, die vom übergeordneten Element während der Layouterstellung berücksichtigt wird. Dieser Wert wird in den Koordinaten der Komponente in Pixeln angegeben. Der Standardwert dieser Eigenschaft wird vom Komponentenentwickler eingestellt.

Mit dieser Eigenschaft legt der Komponentenentwickler eine Höchstgrenze für die Höhe der Komponente fest.

Überschreibt der Anwendungsentwickler den Standardwert von maxHeight, wird der neue Wert in explicitMaxHeight gespeichert. Der Standardwert von maxHeight wird nicht geändert. Wurde maxHeight explizit vom Anwendungsentwickler festgelegt, wird daher zum Zeitpunkt der Layouterstellung als empfohlener Höchstwert für die Höhe der Komponente der Wert von explicitMaxHeight verwendet. Wird maxHeight nicht explizit vom Benutzer eingestellt, wird der Standardwert verwendet.

Dieser Wert wird vom Container beim Berechnen von Größe und Position der Komponente verwendet. Er wird nicht von der Komponente selbst zum Bestimmen der Standardgröße verwendet. Daher hat diese Eigenschaft möglicherweise keine Wirkung, wenn das übergeordnete Element einem oder mehreren Container(n) entspricht, die diese Eigenschaft nicht berücksichtigen. Da der Wert in Komponentenkoordinaten angegeben wird, wird die tatsächliche maxHeight mit Bezug zum übergeordneten Objekt von der scaleY-Eigenschaft beeinflusst. Bei manchen Komponenten ist die Höhe theoretisch unbeschränkt. In diesen Fällen wird die maxHeight auf UIComponent.DEFAULT_MAX_HEIGHT gesetzt.

Die empfohlene maximale Breite der Komponente, die vom übergeordneten Element während der Layouterstellung berücksichtigt wird. Dieser Wert wird in den Koordinaten der Komponente in Pixeln angegeben. Der Standardwert dieser Eigenschaft wird vom Komponentenentwickler eingestellt.

Mit dieser Eigenschaft legt der Komponentenentwickler eine Höchstgrenze für die Breite der Komponente fest.

Überschreibt der Anwendungsentwickler den Standardwert von maxWidth, wird der neue Wert in explicitMaxWidth gespeichert. Der Standardwert von maxWidth wird nicht geändert. Wurde maxWidth explizit vom Anwendungsentwickler festgelegt, wird daher zum Zeitpunkt der Layouterstellung als empfohlener Höchstwert für die Breite der Komponente der Wert von explicitMaxWidth verwendet. Wird maxWidth nicht explizit vom Benutzer eingestellt, wird der Standardwert verwendet.

Dieser Wert wird vom Container beim Berechnen von Größe und Position der Komponente verwendet. Er wird nicht von der Komponente selbst zum Bestimmen der Standardgröße verwendet. Daher hat diese Eigenschaft möglicherweise keine Wirkung, wenn das übergeordnete Element einem oder mehreren Container(n) entspricht, die diese Eigenschaft nicht berücksichtigen. Da der Wert in Komponentenkoordinaten angegeben wird, wird die tatsächliche maxWidth mit Bezug zum übergeordneten Objekt von der scaleX-Eigenschaft beeinflusst. Bei manchen Komponenten ist die Breite theoretisch unbeschränkt. In diesen Fällen wird die maxWidth auf UIComponent.DEFAULT_MAX_WIDTH gesetzt.

Die Standardhöhe der Komponente in Pixeln. Dieser Wert wird von der measure()-Methode festgelegt.

Die Standardbreite der Komponente in Pixeln. Dieser Wert wird von der measure()-Methode festgelegt.

Die linke obere Ecke der standardmäßig gemessenen Grenzen relativ zum Ursprung des Elements.

Die linke obere Ecke der standardmäßig gemessenen Grenzen relativ zum Ursprung des Elements.

Die empfohlene Mindesthöhe der Komponente, die vom übergeordneten Element während der Layouterstellung berücksichtigt wird. Dieser Wert wird in den Koordinaten der Komponente in Pixeln angegeben. Der Standardwert hängt von der Implementierung der Komponente ab.

Legt der Anwendungsentwickler den Wert von minHeight fest, wird der neue Wert in explicitMinHeight gespeichert. Der Standardwert von minHeight wird nicht geändert. Wurde minHeight explizit vom Anwendungsentwickler festgelegt, wird daher zum Zeitpunkt der Layouterstellung als empfohlener Mindestwert für die Höhe der Komponente der Wert von explicitMinHeight verwendet. Wird minHeight nicht explizit vom Anwendungsentwickler eingestellt, wird der Wert von measuredMinHeight verwendet.

Dieser Wert wird vom Container beim Berechnen von Größe und Position der Komponente verwendet. Er wird nicht von der Komponente selbst zum Bestimmen der Standardgröße verwendet. Daher hat diese Eigenschaft möglicherweise keine Wirkung, wenn das übergeordnete Element einem oder mehreren Container(n) entspricht, die diese Eigenschaft nicht berücksichtigen. Da der Wert in Komponentenkoordinaten angegeben wird, wird die tatsächliche minHeight mit Bezug zum übergeordneten Objekt von der scaleY-Eigenschaft beeinflusst.

Die empfohlene Mindestbreite der Komponente, die vom übergeordneten Element während der Layouterstellung berücksichtigt wird. Dieser Wert wird in den Koordinaten der Komponente in Pixeln angegeben. Der Standardwert hängt von der Implementierung der Komponente ab.

Legt der Anwendungsentwickler den Wert von minWidth fest, wird der neue Wert in explicitMinWidth gespeichert. Der Standardwert von minWidth wird nicht geändert. Wurde minWidth explizit vom Anwendungsentwickler festgelegt, wird daher zum Zeitpunkt der Layouterstellung als empfohlener Mindestwert für die Breite der Komponente der Wert von explicitMinWidth verwendet. Wird minWidth nicht explizit vom Anwendungsentwickler eingestellt, wird der Wert von measuredMinWidth verwendet.

Dieser Wert wird vom Container beim Berechnen von Größe und Position der Komponente verwendet. Er wird nicht von der Komponente selbst zum Bestimmen der Standardgröße verwendet. Daher hat diese Eigenschaft möglicherweise keine Wirkung, wenn das übergeordnete Element einem oder mehreren Container(n) entspricht, die diese Eigenschaft nicht berücksichtigen. Da der Wert in Komponentenkoordinaten angegeben wird, wird die tatsächliche minWidth mit Bezug zum übergeordneten Objekt von der scaleX-Eigenschaft beeinflusst.

„True“, wenn das Element ein exklusives DisplayObject erfordert. Diese Methode wird normalerweise nicht direkt vom Entwickler aufgerufen, sondern in Unterklassen überschrieben, um anzugeben, dass ein exklusives DisplayObject benötigt wird. Normalerweise benötigt eine Unterklasse ein DisplayObject, wenn sie ihre Eigenschaften festlegen soll. Im Folgenden einige Beispiele für DisplayObject-Eigenschaften: filters, blendMode, mask, rotation und alpha.

Der Eigentümer dieses IVisualElement-Objekts. Standardmäßig ist dies das übergeordnete Objekt dieses IVisualElement-Objekts. Wenn jedoch dieses IVisualElement eine untergeordnete Komponente ist, die von ihrer übergeordneten Komponente als Popup angezeigt wird, wie etwa die Dropdownliste eines ComboBox-Steuerelements, ist der Eigentümer die Komponente, die dieses IVisualElement-Objekt als Popup angezeigt hat.

Diese Eigenschaft wird nicht von Flex, sondern von jeder Komponente selbst verwaltet. Wenn Sie also die PopUpManger.createPopUp()- oder die PopUpManger.addPopUp()-Methode verwenden, um eine untergeordnete Komponente als Popup anzuzeigen, sollten Sie die owner-Eigenschaft der untergeordneten Komponente auf die Komponente, die sie als Popup angezeigt hat, setzen.

Standardmäßig ist dies der Wert der parent-Eigenschaft.

Der übergeordnete Container oder die übergeordnete Komponente für diese Komponente. Nur visuelle Elemente sollten über eine parent-Eigenschaft verfügen. Nicht visuelle Elemente sollten eine andere Eigenschaft verwenden, um auf das Objekt zu verweisen, zu dem sie gehören. Üblicherweise sollten nicht visuelle Objekte eine owner-Eigenschaft verwenden, um auf das Objekt zu verweisen, zu dem sie gehören.

Legt die Höhe einer Komponente als Prozentsatz der Größe ihres übergeordneten Objekts fest. Zulässige Werte sind 0 bis 100. Die Einstellung der Eigenschaften height oder explicitHeight führt dazu, dass diese Eigenschaft auf „NaN“ zurückgesetzt wird.

Diese Eigenschaft gibt nur dann einen numerischen Wert zurück, wenn die Eigenschaft zuvor eingestellt wurde. Der Wert spiegelt nicht die exakte Größe der Komponente in Prozent wider.

Legt die Breite einer Komponente als Prozentsatz der Größe ihres übergeordneten Objekts fest. Zulässige Werte sind 0 bis 100. Der Standardwert ist NaN. Die Einstellung der Eigenschaften width oder explicitWidth führt dazu, dass diese Eigenschaft auf „NaN“ zurückgesetzt wird.

Diese Eigenschaft gibt nur dann einen numerischen Wert zurück, wenn die Eigenschaft zuvor eingestellt wurde. Der Wert spiegelt nicht die exakte Größe der Komponente in Prozent wider.

Für das UITextField-Steuerelement ist diese Eigenschaft immer auf NaN eingestellt.

Wenn diese Eigenschaft bei Spark-Layouts verwendet wird, wird mit ihrer Hilfe die Breite der Komponentengrenzen nach Skalierung und Drehung berechnet. Beispiel: Wenn die Komponente bei 90 Grad gedreht wird, wirkt sich die Festlegung von percentWidth auf die Breite der Komponente aus.

Definiert Anpassungen, die auf die Transformation des Objekts angewendet werden können, jedoch für das Layout des übergeordneten Objekts unsichtbar bleiben.

Wenn Sie beispielsweise das Layout eines Objekts anpassen möchten, das um 90 Grad gedreht wird, legen Sie die rotation-Eigenschaft des Objekts fest. Wenn das Layout des gedrehten Objekts nicht angepasst werden soll, legen Sie dessen postLayoutTransformOffsets.rotationZ-Eigenschaft fest.

Der horizontale Abstand in Pixeln von der rechten Kante der Komponente zur rechten Kante des Ankerziels.

Standardmäßig entspricht das Ankerziel dem Inhaltsbereich des Containers. In Layouts mit erweiterten Beschränkungen kann das Ziel eine Beschränkungsspalte sein.

Mit dem Einstellen der Eigenschaft auf eine Zahl oder einen numerischen String wie „10“ wird die Verwendung des standardmäßigen Ankerziels festgelegt.

Um ein Ankerziel anzugeben, stellen Sie den Eigenschaftswert auf einen String im Format „anchorTargetName:value“ ein. Beispiel: „col1:10“.

Gibt die Drehung des Elements in Grad vom Transformationspunkt an.

Gibt die x-Achsendrehung der Elementinstanz in Grad ab der ursprünglichen Ausrichtung relativ zum übergeordneten 3D-Container an. Werte zwischen 0 und 180 geben eine Rechtsdrehung, Werte zwischen 0 und -180 eine Linksdrehung an. Werte außerhalb dieses Bereichs werden zu 360 addiert bzw. von 360 subtrahiert, damit sich ein Wert innerhalb des Bereichs ergibt. Diese Eigenschaft wird während der Berechnung von 2D-Layouts in Flex ignoriert.

Gibt die y-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. Werte zwischen 0 und 180 geben eine Rechtsdrehung, Werte zwischen 0 und -180 eine Linksdrehung an. Werte außerhalb dieses Bereichs werden zu 360 addiert bzw. von 360 subtrahiert, damit sich ein Wert innerhalb des Bereichs ergibt. Diese Eigenschaft wird während der Berechnung von 2D-Layouts in Flex ignoriert.

Gibt die Drehung des Elements in Grad vom Transformationspunkt an.

Die horizontale Skalierung (percentage) des Elements ausgehend vom Transformationspunkt.

Die vertikale Skalierung (percentage) des Elements ausgehend vom Transformationspunkt.

Die z-Skalierung (percentage) des Elements ausgehend vom Transformationspunkt.

Der vertikale Abstand in Pixeln vom oberen Rand der Komponente zum oberen Rand des Ankerziels.

Standardmäßig entspricht das Ankerziel dem Inhaltsbereich des Containers. In Layouts mit erweiterten Beschränkungen kann das Ziel eine Beschränkungszeile sein.

Mit dem Einstellen der Eigenschaft auf eine Zahl oder einen numerischen String wie „10“ wird die Verwendung des standardmäßigen Ankerziels festgelegt.

Um ein Ankerziel anzugeben, stellen Sie den Eigenschaftswert auf einen String im Format „anchorTargetName:value“ ein. Beispiel: „row1:10“.

Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören. Die spezifischen Eigenschaften – „matrix“, „colorTransform“ und drei schreibgeschützte Eigenschaften (concatenatedMatrix, concatenatedColorTransform und pixelBounds) – werden im Eintrag für die Transform-Klasse erläutert.

Jede Eigenschaft des transform-Objekts ist selbst wiederum ein Objekt. Dies ist wichtig, da für matrix- und colorTransform-Objekte neue Werte nur gesetzt werden können, indem ein neues Objekt erstellt und in die transform.matrix- oder transform.colorTransform-Eigenschaft kopiert wird.

Um etwa den tx-Wert einer Anzeigeobjekt-Matrix zu erhöhen, müssen Sie eine Kopie des gesamten Matrixobjekts anfertigen und anschließend das neue Objekt in die matrix-Eigenschaft des transform-Objekts kopieren:

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

Sie können die tx-Eigenschaft nicht direkt setzen. Der folgende Code hat keine Auswirkung auf myDisplayObject:

    myDisplayObject.transform.matrix.tx += 10;
    

Eine andere Möglichkeit besteht darin, das gesamte transform-Objekt zu kopieren und es der transform-Eigenschaft eines anderen Anzeigeobjekts zuzuweisen. Der nachfolgende Code kopiert z. B. das gesamte transform-Objekt von myOldDisplayObj nach myNewDisplayObj:

Das resultierende Anzeigeobjekt, myNewDisplayObj, besitzt jetzt für seine Matrix, Farbtransformation und Pixelbegrenzungen dieselben Werte wie das alte Anzeigeobjekt, myOldDisplayObj.

Beachten Sie, dass Geräte mit AIR für TV für Farbtransformierungen automatisch die Hardwarebeschleunigung verwenden, sofern verfügbar.

Die x-Position des Transformationspunkts für dieses Element.

Die y-Position des Transformationspunkts für dieses Element.

Die y-Position des Transformationspunkts für dieses Element.

Der vertikale Abstand in Pixeln von der Mitte der Komponente zur Mitte des Inhaltsbereichs des Ankerziels.

Das standardmäßige Ankerziel ist der Container selbst.

In Layouts mit erweiterten Beschränkungen kann das Ankerziel eine Beschränkungszeile sein. Dann entspricht der Inhaltsbereich dem Raum zwischen der vorherigen Zeile (oder Containerseite) und der Zielzeile.

Mit dem Einstellen der Eigenschaft auf eine Zahl oder einen numerischen String wie „10“ wird die Verwendung des standardmäßigen Ankerziels festgelegt.

Um ein Ankerziel anzugeben, stellen Sie den Eigenschaftswert auf einen String im Format „constraintColumnId:value“ ein. Beispiel: „row1:10“.

Steuert die Sichtbarkeit dieses visuellen Elements. Bei true ist das Objekt sichtbar.

Ist ein Objekt nicht sichtbar, aber die includeInLayout-Eigenschaft ist auf true gesetzt, dann nimmt das Objekt zwar Platz im Container ein, ist aber unsichtbar.

Wenn visible auf true eingestellt ist, ist das Objekt möglicherweise aufgrund seiner Größe und je nachdem, ob Container-Clipping aktiviert ist oder nicht, nicht unbedingt sichtbar.

Wird visible auf false eingestellt, verhindert dies, dass die Komponente den Fokus erhält.

Die Breite des Grafikelements.

Der Standardwert ist 0.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

Die x-Position des Grafikelements.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

Die y-Position des Grafikelements.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

Die z-Position des Grafikelements.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.

Gibt true zurück, wenn dieses IGraphicElement kompatibel ist und Anzeigeobjekte gemeinsam mit dem nächsten IGraphicElement in der Sequenz verwenden kann.

Parameter

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

Bestimmt, ob der Aufruf der measure()-Methode übersprungen werden kann.

Verarbeitet die für das Element eingestellten Eigenschaften. Dies ist eine erweiterte Methode, die Sie bei der Erstellung einer Unterklasse überschreiben können.

Sie können diese Methode nicht direkt aufrufen. Flex ruft die commitProperties()-Methode auf, wenn Sie mit der addElement()-Methode ein Element einem IGraphicElementContainer-Container wie Group hinzufügen oder wenn Sie die invalidateProperties()-Methode des Elements aufrufen. Aufrufe der commitProperties()-Methode erfolgen vor Aufrufen der measure()-Methode. Auf diese Weise können Sie Eigenschaftswerte festlegen, die von der measure()-Methode verwendet werden können.

Einige Elemente verfügen über Eigenschaften, die miteinander interagieren. Es ist oft am besten, zu Beginn alle diese Eigenschaften in einem Vorgang zu verarbeiten, um unnötige Mehrarbeit zu vermeiden.

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.

Gibt die x-Koordinate der Grenzen des Elements für die angegebene Elementgröße zurück.

Diese Methode wird normalerweise von Layouts während des Aufrufs der measure()-Methode verwendet, um vorherzusagen, welche Position das Element einnimmt, wenn dessen Größe auf bestimmte Abmessungen geändert wird.

Parameter

Gibt die y-Koordinate der Grenzen des Elements für die angegebene Elementgröße zurück. Diese Methode wird normalerweise von Layouts während des Aufrufs von measure()-verwendet, um vorherzusagen, welche Position das Element einnimmt, wenn dessen Größe auf bestimmte Abmessungen geändert wird.

Parameter

Gibt die Layouthöhe des Elements zurück. Dies ist die Größe, die für das Zeichnen des Elements auf dem Bildschirm verwendet wird.

Parameter

Gibt die Layoutbreite des Elements zurück. Dies ist die Größe, die für das Zeichnen des Elements auf dem Bildschirm verwendet wird.

Parameter

Gibt die x-Koordinate zurück, die für das Zeichnen des Elements auf dem Bildschirm verwendet wird.

Parameter

Gibt die y-Koordinate zurück, die für das Element beim Zeichnen auf dem Bildschirm verwendet wird.

Parameter

Gibt die Transformationsmatrix zurück, die zur Berechnung des Layouts der Komponente relativ zu ihren Parallelobjekten verwendet wird.

Diese Matrix wird normalerweise durch die 2D-Eigenschaften der Komponente, wie etwa x, y, rotation, scaleX, scaleY, transformX und transformY definiert. Manche Komponenten können zusätzliche Transformationseigenschaften aufweisen, die auf der Layoutmatrix angewendet werden, um die endgültige, berechnete Matrix zu bestimmen. Beispielsweise definiert UIComponent die offsets-Eigenschaft.

Gibt die Layouttransformations-Matrix3D für dieses Element zurück.

Diese Matrix wird normalerweise durch die Transformationseigenschaften der Komponente definiert, wie etwa x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX und transformY. Manche Komponenten können zusätzliche Transformationseigenschaften aufweisen, die auf der Layoutmatrix angewendet werden, um die endgültige, berechnete Matrix zu bestimmen. Beispielsweise definiert UIComponent die offsets-Eigenschaft.

Gibt die maximale Höhe des Elements zurück.

Parameter

Gibt die maximale Breite des Elements zurück.

Parameter

Gibt die Mindesthöhe des Elements zurück.

Parameter

Gibt die Mindestbreite des Elements zurück.

Parameter

Gibt die bevorzugte Höhe des Elements zurück.

Parameter

Gibt die bevorzugte Breite des Elements zurück.

Parameter

Gibt die Anzahl Pixel zurück, die vom Strich an allen Seiten der Elementgrenzen eingenommen wird.

Parameter

Wird automatisch vom MXML-Compiler aufgerufen, wenn das GraphicElement mithilfe eines MXML-Tags erstellt wird. Wenn Sie das GraphicElement mit ActionScript erstellen, müssen Sie die id- Eigenschaft manuell einstellen.

Parameter

Der Aufruf dieser Methode bewirkt einen Aufruf der validateDisplayList()-Methode des Elements, bevor die Anzeigeliste wiedergegeben wird.

Unterklassen sollten diese Methode überschreiben und ihre Arbeit mit der updateDisplayList()-Methode ausführen.

Dienstprogrammmethode, die den Host benachrichtigt, dass dieses Element geändert wurde und dessen Ebene aktualisiert werden muss.

Elemente müssen diese Methode aufrufen, wenn ihre eigene layoutDirection oder die layoutDirection des übergeordneten Elements geändert wird. Bei Unterschieden ist diese Methode dafür zuständig, den Inhalt des Elements zu spiegeln und die Transformation des Elements nach dem Layout so zu aktualisieren, dass die Nachfolger ein gespiegeltes Koordinatensystem erben. IVisualElements implementieren die Spiegelung in der Regel, indem sie mithilfe von postLayoutTransformOffsets die x-Achse um -1 skalieren und die x-Koordinate des Ursprungs um die Breite des Elements verschieben. Der Nettoeffekt dieser „Spiegeltransformation“ ist eine Umkehrung der Richtung, in welcher die x-Achse verlängert wird, ohne dass die Position des Elements relativ zum Ursprung seines übergeordneten Elements verändert wird.

Helper-Methode zur Invalidierung der Größe und Anzeigeliste des übergeordneten Objekts, wenn sich dieses Objekt auf das Layout (includeInLayout entspricht „true“) auswirkt.

Der Aufruf dieser Methode bewirkt einen Aufruf der validateProperties()-Methode des Elements, bevor die Anzeigeliste wiedergegeben wird.

Unterklassen sollten ihre Arbeit mit der commitProperties()-Methode ausführen.

Der Aufruf dieser Methode bewirkt einen Aufruf der validateSize()-Methode des Elements, bevor die Anzeigeliste wiedergegeben wird.

Unterklassen sollten diese Methode überschreiben und ihre Messung mit der measure()-Methode ausführen. Wenn explicitWidth und explicitHeight festgelegt sind, wird measure() standardmäßig nicht aufgerufen. Um das Standardverhalten zu überschreiben, sollten Unterklassen die skipMeasure()-Methode überschreiben.

Konvertiert das point-Objekt von den (lokalen) Koordinaten des Objekts in die (globalen) Bühnenkoordinaten.

Mit dieser Methode können Sie beliebige x- und y-Koordinaten von Werten, die relativ zum Ursprung (0,0) eines bestimmten Objekts (lokale Koordinaten) sind, in Werte umwandeln, die relativ zum Ursprung der Bühne (globale Koordinaten) sind.

Um diese Methode zu verwenden, erstellen Sie zuerst eine Instanz der Point-Klasse. Die x- und y-Werte, die Sie zuweisen, repräsentieren lokale Koordinaten, weil sie sich auf den Ursprung des Objekts beziehen.

Dann übergeben Sie die Point-Instanz, die Sie erstellt haben, als Parameter an die localToGlobal()-Methode. Die Methode gibt ein neues point-Objekt mit x- und y-Werten zurück, die sich auf den Ursprung der Bühne beziehen, anstatt auf den Ursprung des Objekts.

Parameter

Verwandte API-Elemente

Berechnet die Standardgröße des Elements. Dies ist eine erweiterte Methode, die Sie bei der Erstellung einer Unterklasse für ein GraphicElement überschreiben können.

Sie können diese Methode nicht direkt aufrufen. Flex ruft die measure()-Methode auf, wenn das Element einem IGraphicElementContainer-Container wie Group mit der addElement()-Methode hinzugefügt wird und wenn die invalidateSize()-Methode des Elements aufgerufen wird.

Wenn Sie eine spezifische Höhe und Breite eines Elements festlegen, ruft Flex standardmäßig die measure()-Methode nicht auf, auch wenn Sie die invalidateSize()-Methode explizit aufrufen. Um dieses Standardverhalten zu überschreiben, überschreiben Sie die skipMeasure()-Methode.

Für die Überschreibung dieser Methode müssen Sie die Eigenschaften measuredWidth und measuredHeight festlegen, um die Standardgröße zu definieren. Sie können optional die Eigenschaften measuredX und measuredY einstellen, um die standardmäßig gemessenen Grenzen der linken oberen Ecke relativ zum Ursprung des Elements zu definieren.

measure() wurde dazu konzipiert, dass das Element die eigenen natürlichen oder inhärenten Werte als Standard bereitstellt. Daher sollten die Eigenschaften measuredWidth und measuredHeight von Faktoren wie den folgenden bestimmt werden:

• Textmenge, die von der Komponente angezeigt werden muss.
• Die Größe eines JPEG-Bilds, das von der Komponente angezeigt wird.

In einigen Fällen gibt es keine natürliche Art zur Bestimmung der Standardwerte. Beispielsweise kann ein einfaches GreenCircle-Element in der measure()-Methode für measuredWidth = 100 und measuredHeight = 100 festlegen, um eine angemessene Standardgröße anzugeben. In anderen Fällen, wie beispielsweise bei einem Textbereich, kann eine entsprechende Berechnung (wie die Suche nach der richtigen Breite und Höhe zur Anzeige des gesamten Texts im Seitenverhältnis eines Goldenen Rechtecks) zu zeitaufwendig sein.

Die Standardimplementierung von measure() setzt die Werte für die Eigenschaften measuredWidth, measuredHeight, measuredX und measuredY auf 0.

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

Wird für die Implementierung der ILayoutElement-Schnittstelle verwendet und gibt den expliziten Wert für die gemessene Höhe vor der Transformation zurück.

Wird für die Implementierung der ILayoutElement-Schnittstelle verwendet und gibt den expliziten Wert für die gemessene Breite vor der Transformation zurück.

Legt die Koordinaten fest, die für das Zeichnen des Elements auf dem Bildschirm verwendet werden.

Aufrufe der setLayoutBoundSize()-Methode können sich auf die Layoutposition auswirken. Rufen Sie deshalb setLayoutBoundPosition() auf, nachdem Sie setLayoutBoundSize() aufgerufen haben.

Parameter

Legt die Layoutgröße des Elements fest. Dies ist die Größe, die für das Zeichnen des Elements auf dem Bildschirm verwendet wird.

Wenn die width- und/oder height-Parameter nicht angegebene werden (NaN), stellt Flex die Layoutgröße des Elements auf dessen bevorzugte Breite bzw. Höhe ein.

Aufrufe der setLayoutBoundSize()-Methode können sich auf die Layoutposition auswirken. Rufen Sie deshalb setLayoutBoundPosition() auf, nachdem Sie setLayoutBoundSize() aufgerufen haben.

Parameter

Legt die Transformationsmatrix fest, die verwendet wird, um die Layoutgröße der Komponente und die Position relativ zu den Geschwisterelementen zu berechnen.

Die Matrix wird normalerweise mit den 2D-Eigenschaften der Komponente wie x, y, rotation, scaleX, scaleY, transformX und transformY definiert. Manche Komponenten können zusätzliche Transformationseigenschaften aufweisen, die auf der Layoutmatrix angewendet werden, um die endgültige, berechnete Matrix zu bestimmen. Beispielsweise definiert UIComponent die offsets.

Beachten Sie, dass die Layout-Matrix in getPreferredSize(), getMinSize(), getMaxSize() und getLayoutSize() unterteilt ist, wenn sie in übergeordneten Koordinaten berechnet wird, sowie in getLayoutPosition() für übergeordnete und untergeordnete Koordinaten. Layouts, die die Transformationsmatrix explizit berechnen, rufen diese Methode normalerweise auf und arbeiten mit Größen in untergeordneten Koordinaten. Layouts, die diese Methode aufrufen, übergeben false an die invalidateLayout()-Methode, sodass keine nachfolgende Übergabe eines Layouts ausgelöst wird.

Parameter

Legt die Transformations-Matrix3D fest, die zur Berechnung der Layoutgröße und -position der Komponenete relativ zu ihren Parallelobjekten verwendet wird.

Diese Matrix wird normalerweise durch die Transformationseigenschaften der Komponente definiert, wie etwa x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX und transformY. Manche Komponenten können zusätzliche Transformationseigenschaften aufweisen, die auf der Layoutmatrix angewendet werden, um die endgültige, berechnete Matrix zu bestimmen. Beispielsweise definiert UIComponent die offsets-Eigenschaft.

Beachten Sie, dass die Layout-Matrix3D in getPreferredSize(), getMinSize(), getMaxSize() und getLayoutSize() berücksichtigt wird, wenn sie in übergeordneten Koordinaten berechnet wird, und in getLayoutPosition() für übergeordnete und untergeordnete Koordinaten. Layouts, die die Transformationsmatrix explizit berechnen, rufen diese Methode normalerweise auf und arbeiten mit Größen in untergeordneten Koordinaten. Layouts, die diese Methode aufrufen, übergeben false an die invalidateLayout()-Methode, sodass keine nachfolgende Übergabe eines Layouts ausgelöst wird.

Parameter

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

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. Diese Funktion weist die bereitgestellten Drehungs-, Skalierungs- und Versetzungswerte zu und aktualisiert dann die x/y/z-Eigenschaften nach Bedarf, um den Transformationsmittelpunkt unverändert beizubehalten.

Parameter

Transformieren Sie die Größe des Elements.

Diese Methode berechnet den Begrenzungsrahmen des Grafikelements, als ob seine Eigenschaften „Breite/Höhe“ auf die übergebenen Werte eingestellt wären. Die Methode gibt die Höhe des Begrenzungsrahmens zurück.

Im Allgemeinen ist diese Methode nicht für die Verwendung durch Anwendungsentwickler vorgesehen. Stattdessen sollten Sie die Methoden gemäß derILayoutElement-Schnittstelle implementieren oder überschreiben.

Parameter

Eine Dienstmethode, mit der die lokalen Koordinaten eines Punkts dieses Objekts transformiert werden in seine Position innerhalb der Koordinaten des übergeordneten Elements dieses Objekts. Die Ergebnisse vor und nach dem Layout werden in den Parametern position und postLayoutPosition festgelegt, wenn sie nicht null sind.

Parameter

Transformieren Sie die Größe des Elements.

Diese Methode berechnet den Begrenzungsrahmen des Grafikelements, als ob seine Eigenschaften „Breite/Höhe“ auf die übergebenen Werte eingestellt wären. Diese Methode gibt die Breite des Begrenzungsrahmens zurück.

Im Allgemeinen ist diese Methode nicht für die Verwendung durch Anwendungsentwickler vorgesehen. Stattdessen sollten Sie die Methoden gemäß derILayoutElement-Schnittstelle implementieren oder überschreiben.

Parameter

Zeichnet das Element und/oder die Größen und Positionen seines Inhalts. Dies ist eine erweiterte Methode, die Sie bei der Erstellung einer Unterklasse für ein GraphicElement überschreiben können.

Sie können diese Methode nicht direkt aufrufen. Flex ruft die updateDisplayList()-Methode auf, wenn die Komponente einem IGraphicElementContainer-Container wie Group mit der addElement()-Methode hinzugefügt wird und wenn die invalidateDisplayList()-Methode des Elements aufgerufen wird.

Dies ist die Methode, mit der Sie programmgesteuert zeichnen können, indem Sie Methoden wie graphics.drawRect() für das displayObject des Elements verwenden.

Parameter

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.

Validiert und aktualisiert die Eigenschaften und das Layout dieses Objekts, indem erforderlichenfalls unverzüglich validateProperties(), validateSize() und validateDisplayList() aufgerufen wird.

Wird von der Layoutlogik verwendet, um die Eigenschaften einer Komponente durch Aufrufen der commitProperties()-Methode zu validieren. Im Allgemeinen sollten Unterklassen die commitProperties()-Methode überschreiben und nicht diese Methode.

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.