| Paket | spark.core |
| Arabirim | public interface IGraphicElement extends IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
| Uygulayıcılar | GraphicElement |
| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
IGraphicElementContainer
DisplayObject management.
One typical use case is DisplayObject sharing.
the Group class, which implements IGraphicElementContainer, organizes its
IGraphicElement children in sequences that share and draw to
the same DisplayObject.
The DisplayObject is created by the first element in the
sequence.
Another use case is when an element does not derive from
DisplayObject but instead maintains, creates and/or destroys
its own DisplayObject. The IGraphicElementContainer will
call the element to create the DisplayObject, add the
DisplayObject as its child at the correct index, and
handle its removal.
Typically, you extend the GraphicElement class instead of directly implementing the IGraphciElement interface. The GraphicElement class already provides most of the required functionality.
İlgili API Öğeleri
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster| Özellik | Tanımlayan: | ||
|---|---|---|---|
 | alpha : Number
Belirtilen nesnenin alfa saydamlık değerini gösterir. | IVisualElement | |
| baseline : Object
The vertical distance in pixels from the anchor target to
the control's baseline position. | ILayoutElement | |
| baselinePosition : Number [salt okunur]
The y-coordinate of the baseline
of the first line of text of the component. | ILayoutElement | |
| bottom : Object
The vertical distance in pixels from the bottom edge of the component to the
anchor target's bottom edge. | ILayoutElement | |
| depth : Number
Determines the order in which items inside of containers
are rendered. | IVisualElement | |
| designLayer : DesignLayer
Specifies the optional DesignLayer instance associated with this visual
element. | IVisualElement | |
| displayObject : DisplayObject [salt okunur]
The shared DisplayObject where this
IGraphicElement is drawn. | IGraphicElement | ||
| displayObjectSharingMode : String
Indicates the association between this IGraphicElement and its
display objects. | IGraphicElement | ||
| hasLayoutMatrix3D : Boolean [salt okunur]
Contains true if the element has 3D Matrix. | ILayoutElement | |
| height : Number
Görüntüleme nesnesinin yüksekliğini, piksel cinsinden belirtir. | IVisualElement | |
| horizontalCenter : Object
The horizontal distance in pixels from the center of the component to the
center of the anchor target's content area. | ILayoutElement | |
| includeInLayout : Boolean
Specifies whether this component is included in the layout of the
parent container. | ILayoutElement | |
| is3D : Boolean [salt okunur]
Contains true when the element is in 3D. | IVisualElement | |
| layoutDirection : String
Specifies the desired layout direction for an element: one of LayoutDirection.LTR
(left to right), LayoutDirection.RTL (right to left), or null (inherit). | ILayoutDirectionElement | |
| left : Object
The horizontal distance in pixels from the left edge of the component to the
anchor target's left edge. | ILayoutElement | |
| owner : DisplayObjectContainer
The owner of this IVisualElement object. | IVisualElement | |
| parent : DisplayObjectContainer [salt okunur]
The parent container or component for this component. | IVisualElement | |
| percentHeight : Number
Specifies the height of a component as a percentage
of its parent's size. | ILayoutElement | |
| percentWidth : Number
Specifies the width of a component as a percentage
of its parent's size. | ILayoutElement | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Defines a set of adjustments that can be applied to the object's
transform in a way that is invisible to its parent's layout. | IVisualElement | |
| right : Object
The horizontal distance in pixels from the right edge of the component to the
anchor target's right edge. | ILayoutElement | |
| top : Object
The vertical distance in pixels from the top edge of the component to the
anchor target's top edge. | ILayoutElement | |
| verticalCenter : Object
The vertical distance in pixels from the center of the component to the
center of the anchor target's content area. | ILayoutElement | |
| visible : Boolean
Controls the visibility of this visual element. | IVisualElement | |
| width : Number
Görüntüleme nesnesinin genişliğini, piksel cinsinden belirtir. | IVisualElement | |
| x : Number
DisplayObject örneğinin DisplayObjectContainer üst öğesinin yerel koordinatlarına göre x koordinatını belirtir. | IVisualElement | |
| y : Number
DisplayObject örneğinin DisplayObjectContainer üst öğesinin yerel koordinatlarına göre y koordinatını belirtir. | IVisualElement | |
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | IEventDispatcher | |
Returns true if this IGraphicElement is compatible and can
share display objects with the next IGraphicElement
in the sequence. | IGraphicElement | ||
Returns true if this IGraphicElement is compatible and can
share display objects with the previous IGraphicElement
in the sequence. | IGraphicElement | ||
Creates a new DisplayObject where this IGraphicElement
is drawn. | IGraphicElement | ||
|
Olay akışına bir olay gönderir. | IEventDispatcher | |
|
Returns the x coordinate of the element's bounds at the specified element size. | ILayoutElement | |
|
Returns the y coordinate of the element's bounds at the specified element size. | ILayoutElement | |
|
Returns the element's layout height. | ILayoutElement | |
|
Returns the element's layout width. | ILayoutElement | |
|
Returns the x coordinate that the element uses to draw on screen. | ILayoutElement | |
|
Returns the y coordinate that the element uses to draw on screen. | ILayoutElement | |
|
Returns the transform matrix that is used to calculate the component's
layout relative to its siblings. | ILayoutElement | |
|
Returns the layout transform Matrix3D for this element. | ILayoutElement | |
|
Returns the element's maximum height. | ILayoutElement | |
|
Returns the element's maximum width. | ILayoutElement | |
|
Returns the element's minimum height. | ILayoutElement | |
|
Returns the element's minimum width. | ILayoutElement | |
|
Returns the element's preferred height. | ILayoutElement | |
|
Returns the element's preferred width. | ILayoutElement | |
|
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | IEventDispatcher | |
|
An element must call this method when its layoutDirection changes or
when its parent's layoutDirection changes. | ILayoutDirectionElement | |
Called by IGraphicElementContainer when an IGraphicElement
is added to or removed from the host component. | IGraphicElement | ||
|
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | IEventDispatcher | |
|
Sets the coordinates that the element uses to draw on screen. | ILayoutElement | |
|
Sets the layout size of the element. | ILayoutElement | |
|
Sets the transform Matrix that is used to calculate the component's layout
size and position relative to its siblings. | ILayoutElement | |
|
Sets the transform Matrix3D that is used to calculate the component's layout
size and position relative to its siblings. | ILayoutElement | |
Determines whether this element can draw itself to the
sharedDisplayObject of the sequence. | 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
A utility method to update the rotation, scale, and translation of the
transform while keeping a particular point, specified in the component's
own coordinate space, fixed in the parent's coordinate space. | ILayoutElement | |
Called by the IGraphicElementContainer to redraw this element
in its displayObject property. | IGraphicElement | ||
Called by the IGraphicElementContainer to validate the properties of
this element. | IGraphicElement | ||
Called by the IGraphicElementContainer to validate the size of
this element. | IGraphicElement | ||
|
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | IEventDispatcher | |
displayObject | özellik |
displayObject:DisplayObject [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
The shared DisplayObject where this IGraphicElement is drawn.
Implementers should not create the DisplayObject
here, but in the createDisplayObject() method.
Uygulama
public function get displayObject():DisplayObjectİlgili API Öğeleri
displayObjectSharingMode | özellik |
displayObjectSharingMode:String| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4.5 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 2.5 |
Indicates the association between this IGraphicElement and its
display objects. The IGraphicElementContainer manages this
property and the values are one of the DisplayObjectSharingMode enum class.
- A value of
DisplayObjectSharingMode.OWNS_UNSHARED_OBJECTindicates that the IGraphicElement owns exclusively the DisplayObject corresponding to itsdisplayObjectproperty. - A value of
DisplayObjectSharingMode.OWNS_SHARED_OBJECTindicates taht the IGraphicElement owns the DisplayObject corresponding to itsdisplayObjectproperty but other IGraphicElements are using/drawing to that display object as well. Depending on the specific implementation, the IGraphicElement may perform certain management of the display object. For example the base class GraphicElement clears the transform of the display object, reset its visibility, alpha, etc. properties to their default values and additionally clear the graphics on everyvalidateDisplayList()call. - A value of
DisplayObjectSharingMode.USES_SHARED_OBJECTindicates that the IGraphicElement draws into the DisplayObject corresponding to itsdisplayObjectproperty. There are one or more IGraphicElements that draw into that same displayObject, and the first element that draws has its mode set toDisplayObjectMode.OWNS_SHARED_OBJECT
Uygulama
public function get displayObjectSharingMode():String public function set displayObjectSharingMode(value:String):voidcanShareWithNext | () | yöntem |
public function canShareWithNext(element:IGraphicElement):Boolean| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Returns true if this IGraphicElement is compatible and can
share display objects with the next IGraphicElement
in the sequence.
Parametreler
element:IGraphicElement — The element that comes after this element in the sequence.
|
Boolean — Returns true when this element is compatible with the previous
element in the sequence.
|
İlgili API Öğeleri
canShareWithPrevious | () | yöntem |
public function canShareWithPrevious(element:IGraphicElement):Boolean| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Returns true if this IGraphicElement is compatible and can
share display objects with the previous IGraphicElement
in the sequence.
In certain cases the element might be passed to the IGraphicElementContainer
in a call to the setSharedDisplayObject() method.
In those cases, this method is not called.
Parametreler
element:IGraphicElement — The element that comes before this element in the sequence.
|
Boolean — Returns true when this element is compatible with the previous
element in the sequence.
|
İlgili API Öğeleri
createDisplayObject | () | yöntem |
public function createDisplayObject():DisplayObject| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Creates a new DisplayObject where this IGraphicElement is drawn.
Subsequent calls to the getter of the displayObject property must
return the same display object.
After the DisplayObject is created, the parent IGraphicElementContainer
will pass along the display objects to the rest of the elements in the sequence.
The IGraphicElementContainer ensures that this method is called only when needed.
If the element wants to participate in the DisplayObject
sharing, then the new DisplayObject must implement IShareableDisplayObject.
This interface is being used by the IGraphicElementContainer to manage invalidation and
redrawing of the graphic element sequence and typically is not directly
used by the developer.
To reevaluate the shared sequences, call the
invalidateGraphicElementSharing() method
on the IGraphicElementContainer.
To force the IGraphicElementContainer to remove the element's current
DisplayObject from its display list and recalculate the
display object sharing, call the
discardDisplayObject() method on the IGraphicElementContainer.
DisplayObject — The display object created.
|
İlgili API Öğeleri
parentChanged | () | yöntem |
public function parentChanged(parent:IGraphicElementContainer):void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Called by IGraphicElementContainer when an IGraphicElement
is added to or removed from the host component.
You typically never need to call this method.
Parametreler
parent:IGraphicElementContainer — The IGraphicElementContainer of this IGraphicElement.
|
setSharedDisplayObject | () | yöntem |
public function setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Determines whether this element can draw itself to the
sharedDisplayObject of the sequence.
Typically implementers return true when this
IGraphicElement can cumulatively draw in the shared
DisplayObject graphics property.
In all cases where this IGraphicElement needs to set
properties on the DisplayObjects that don't apply to the
rest of the elements in the sequence, this method must return false.
Examples for such properties are rotation, scale, transform,
mask, alpha, filters, color transform, 3D, and layer.
When this method returns true, subsequent calls to the getter of the
displayObject property must return the same display object.
In certain cases, the sharedDisplayObject property might be
the IGraphicElementContainer itself. In the rest of the cases, the
DisplayObject is created by the first element in the sequence.
When this IGraphicElement needs to rebuild its sequence,
it notifies the IGraphicElementContainer by calling its
invalidateGraphicElementSharing() method.
Parametreler
sharedDisplayObject:DisplayObject — The shared DisplayObject.
|
Boolean — Returns true when this IGraphicElement can draw itself
to the shared DisplayObject of the sequence.
|
İlgili API Öğeleri
validateDisplayList | () | yöntem |
public function validateDisplayList():void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Called by the IGraphicElementContainer to redraw this element
in its displayObject property.
If the element is the first in the sequence (displayObjectSharingMode
is set to DisplayObjectSharingMode.OWNS_SHARED_OBJECT)
then it must clear the displayObject
graphics and set it up as necessary for drawing the rest of the elements.
The element must alway redraw even if it itself has not changed
since the last time the validateDisplayList() method was called.
The parent IGraphicElementContainer will redraw the whole sequence
if any of its elements need to be redrawn.
To ensure this method is called, notify the IGraphicElementContainer
by calling its invalidateGraphicElementSize() method.
This method might be called even if this element has not
notified the IGraphicElementContainer.
İlgili API Öğeleri
validateProperties | () | yöntem |
public function validateProperties():void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Called by the IGraphicElementContainer to validate the properties of
this element.
To ensure that this method is called, notify the IGraphicElementContainer
by calling its invalidateGraphicElementProperties() method.
This method might be called even if this element has not
notified the IGraphicElementContainer.
İlgili API Öğeleri
validateSize | () | yöntem |
public function validateSize():void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flex 4 |
| Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Called by the IGraphicElementContainer to validate the size of
this element.
When the size of the element changes and is going to affect the
IGraphicElementContainer layout, the implementer is responsible
for invalidating the parent's size and display list.
To ensure that this method is called, notify the IGraphicElementContainer
by calling its invalidateGraphicElementSize() method.
This method might be called even if this element has not
notified the IGraphicElementContainer.
İlgili API Öğeleri
Tue Jun 12 2018, 01:09 PM Z