| パッケージ | spark.core |
| インターフェイス | public interface IGraphicElement extends IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher |
| 実装者 | GraphicElement |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
IGraphicElementContainer の DisplayObject 管理を利用する IVisualElement によって実装されます。
一般的な使用例の 1 つとして DisplayObject の共有があります。IGraphicElementContainer を実装する Group クラスは、共有と描画を行うシーケンス内の IGraphicElement の子を、同じ DisplayObject に編成します。 DisplayObject は、シーケンスの最初のエレメントによって作成されます。
別の使用方法としては、エレメントが DisplayObject に由来しないが、独自の DisplayObject を維持、作成または破棄する場合があります。IGraphicElementContainer によってエレメントを呼び出して DisplayObject を作成し、正しいインデックスで DisplayObject を子として追加して、削除を処理します。
通常は、IGraphciElement インターフェイスを直接実装する代わりに、GraphicElement クラスを拡張します。GraphicElement クラスには、必要な機能の大半が既に備わっています。
関連する API エレメント
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示| プロパティ | 定義元 | ||
|---|---|---|---|
 | alpha : Number
指定されたオブジェクトのアルファ透明度値を示します。 | IVisualElement | |
| baseline : Object
アンカーターゲットからコントロールのベースライン位置までの垂直距離（ピクセル単位）です。 | ILayoutElement | |
| baselinePosition : Number [読み取り専用]
コンポーネントのテキストにおける 1 行目のベースラインの y 座標です。 | ILayoutElement | |
| bottom : Object
コンポーネントの下端からアンカーターゲットの下端までの垂直距離（ピクセル単位）です。 | ILayoutElement | |
| depth : Number
コンテナ内のアイテムのレンダリング順序を決定します。 | IVisualElement | |
| designLayer : DesignLayer
このビジュアルエレメントに関連付けるオプションの DesignLayer インスタンスを指定します。 | IVisualElement | |
| displayObject : DisplayObject [読み取り専用]
この IGraphicElement が描画される共有 DisplayObject です。 | IGraphicElement | ||
| displayObjectSharingMode : String
この IGraphicElement とその表示オブジェクトの間の関連付けを示します。 | IGraphicElement | ||
| hasLayoutMatrix3D : Boolean [読み取り専用]
エレメントが 3D マトリックスを持つ場合は true です。 | ILayoutElement | |
| height : Number
表示オブジェクトの高さを示します（ピクセル単位）。 | IVisualElement | |
| horizontalCenter : Object
コンポーネントの中心からアンカーターゲットのコンテンツ領域の中心までの水平距離（ピクセル単位）です。 | ILayoutElement | |
| includeInLayout : Boolean
このコンポーネントを親コンテナのレイアウトに含めるかどうかを指定します。 | ILayoutElement | |
| is3D : Boolean [読み取り専用]
エレメントが 3D の場合は true です。 | IVisualElement | |
| layoutDirection : String
エレメントの任意のレイアウト方向を指定します。LayoutDirection.LTR（左から右）、LayoutDirection.RTL（右から左）または null（継承する）のいずれかを指定します。 | ILayoutDirectionElement | |
| left : Object
コンポーネントの左端からアンカーターゲットの左端までの水平距離（ピクセル単位）です。 | ILayoutElement | |
| owner : DisplayObjectContainer
この IVisualElement オブジェクトのオーナーです。 | IVisualElement | |
| parent : DisplayObjectContainer [読み取り専用]
このコンポーネントの親コンテナまたは親コンポーネントです。 | IVisualElement | |
| percentHeight : Number
コンポーネントの高さを親のサイズに対する比率（パーセンテージ）で指定します。 | ILayoutElement | |
| percentWidth : Number
コンポーネントの幅を親のサイズに対する比率（パーセンテージ）で指定します。 | ILayoutElement | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
親のレイアウトに影響を与えない方法で、オブジェクトの変換に適用できる一連の調整を定義します。 | IVisualElement | |
| right : Object
コンポーネントの右端からアンカーターゲットの右端までの水平距離（ピクセル単位）です。 | ILayoutElement | |
| top : Object
コンポーネントの上端からアンカーターゲットの上端までの垂直距離（ピクセル単位）です。 | ILayoutElement | |
| verticalCenter : Object
コンポーネントの中心からアンカーターゲットのコンテンツ領域の中心までの垂直距離（ピクセル単位）です。 | ILayoutElement | |
| visible : Boolean
このビジュアルエレメントの可視性を制御します。 | IVisualElement | |
| width : Number
表示オブジェクトの幅を示します（ピクセル単位）。 | IVisualElement | |
| x : Number
親 DisplayObjectContainer のローカル座標を基準にした DisplayObject インスタンスの x 座標を示します。 | IVisualElement | |
| y : Number
親 DisplayObjectContainer のローカル座標を基準にした DisplayObject インスタンスの y 座標を示します。 | IVisualElement | |
| メソッド | 定義元 | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | IEventDispatcher | |
この IGraphicElement がシーケンスの次の IGraphicElement と互換性があり、表示オブジェクトを共有できる場合に true を返します。 | IGraphicElement | ||
この IGraphicElement がシーケンスの前の IGraphicElement と互換性があり、表示オブジェクトを共有できる場合に true を返します。 | IGraphicElement | ||
この IGraphicElement が描画される新しい DisplayObject を作成します。 | IGraphicElement | ||
|
イベントをイベントフローに送出します。 | IEventDispatcher | |
|
エレメントの境界の x 座標を、指定したエレメントサイズで返します。 | ILayoutElement | |
|
エレメントの境界の y 座標を、指定したエレメントサイズで返します。 | ILayoutElement | |
|
エレメントのレイアウトの高さを返します。 | ILayoutElement | |
|
エレメントのレイアウトの幅を返します。 | ILayoutElement | |
|
画面に描画するためにエレメントで使用する x 座標を返します。 | ILayoutElement | |
|
画面に描画するためにエレメントで使用する y 座標を返します。 | ILayoutElement | |
|
兄弟を基準としてコンポーネントのレイアウトを計算するために使用される変換マトリックスを返します。 | ILayoutElement | |
|
このエレメントのレイアウト変換 Matrix3D を返します。 | ILayoutElement | |
|
エレメントの最大の高さを返します。 | ILayoutElement | |
|
エレメントの最大の幅を返します。 | ILayoutElement | |
|
エレメントの最小の高さを返します。 | ILayoutElement | |
|
エレメントの最小の幅を返します。 | ILayoutElement | |
|
エレメントの推奨高さを返します。 | ILayoutElement | |
|
エレメントの推奨幅を返します。 | ILayoutElement | |
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | IEventDispatcher | |
|
エレメントの layoutDirection を変更する場合、または親エレメントの layoutDirection を変更する場合は、エレメントでこのメソッドを呼び出す必要があります。 | ILayoutDirectionElement | |
ホストコンポーネントに対して IGraphicElement が追加または削除された場合に IGraphicElementContainer によって呼び出されます。 | IGraphicElement | ||
|
EventDispatcher オブジェクトからリスナーを削除します。 | IEventDispatcher | |
|
画面に描画するためにエレメントで使用する座標を設定します。 | ILayoutElement | |
|
エレメントのレイアウトサイズを設定します。 | ILayoutElement | |
|
兄弟を基準としてコンポーネントのレイアウトサイズおよび位置を計算するために使用される変換 Matrix を設定します。 | ILayoutElement | |
|
兄弟を基準としてコンポーネントのレイアウトサイズおよび位置を計算するために使用される変換 Matrix3D を設定します。 | ILayoutElement | |
このエレメントがシーケンスの sharedDisplayObject に対して自分自身を描画できるかどうかを決定します。 | 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
コンポーネントの独自の座標空間内で指定され、親の座標空間内に固定される、特定のポイントを保持して変換の回転、拡大 / 縮小および平行移動を更新するためのユーティリティメソッドです。 | ILayoutElement | |
displayObject プロパティのこのエレメントを再描画するために、IGraphicElementContainer によって呼び出されます。 | IGraphicElement | ||
このエレメントのプロパティを検証するために IGraphicElementContainer によって呼び出されます。 | IGraphicElement | ||
このエレメントのサイズを検証するために IGraphicElementContainer によって呼び出されます。 | IGraphicElement | ||
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | IEventDispatcher | |
displayObject | プロパティ |
displayObject:DisplayObject [読み取り専用] | 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
この IGraphicElement が描画される共有 DisplayObject です。
インプリメンタはここで DisplayObject を作成するのではなく、createDisplayObject() メソッドで作成する必要があります。
実装
public function get displayObject():DisplayObject関連する API エレメント
displayObjectSharingMode | プロパティ |
displayObjectSharingMode:String| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4.5 |
| ランタイムバージョン: | Flash Player 10, AIR 2.5 |
この IGraphicElement とその表示オブジェクトの間の関連付けを示します。IGraphicElementContainer がこのプロパティを管理し、値は DisplayObjectSharingMode 列挙クラスのいずれかです。
- 値
DisplayObjectSharingMode.OWNS_UNSHARED_OBJECTは、displayObjectプロパティに対応する DisplayObject を IGraphicElement が独占的に所有することを示します。 - 値
DisplayObjectSharingMode.OWNS_SHARED_OBJECTは、IGraphicElement がdisplayObjectプロパティに対応する DisplayObject を所有しますが、他の IGraphicElements もその表示オブジェクトを使用および描画することを示します。具体的な実装に応じて、IGraphicElement は表示オブジェクトの特定の管理を行う場合があります。例えば、基本クラス GraphicElement は、表示オブジェクトの変換をクリアし、可視性やアルファなどのプロパティをデフォルト値にリセットし、さらにすべてのvalidateDisplayList()呼び出しでのグラフィックをクリアします。 - 値
DisplayObjectSharingMode.USES_SHARED_OBJECTは、displayObjectプロパティに対応する DisplayObject に IGraphicElement が描画することを示します。同じ displayObject に描画する IGraphicElements が 1 つ以上あり、最初に描画するエレメントのモードがDisplayObjectMode.OWNS_SHARED_OBJECTに設定されます。
実装
public function get displayObjectSharingMode():String public function set displayObjectSharingMode(value:String):voidcanShareWithNext | () | メソッド |
public function canShareWithNext(element:IGraphicElement):Boolean| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
この IGraphicElement がシーケンスの次の IGraphicElement と互換性があり、表示オブジェクトを共有できる場合に true を返します。
パラメーター
element:IGraphicElement — シーケンス内でこのエレメントの後に続くエレメントです。
|
Boolean — このエレメントがシーケンスの前のエレメントと互換性がある場合に true を返します。
|
関連する API エレメント
canShareWithPrevious | () | メソッド |
public function canShareWithPrevious(element:IGraphicElement):Boolean| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
この IGraphicElement がシーケンスの前の IGraphicElement と互換性があり、表示オブジェクトを共有できる場合に true を返します。
場合によっては、setSharedDisplayObject() メソッドを呼び出すと、エレメントが IGraphicElementContainer に渡されることがあります。 そのような場合、このメソッドは呼び出されません。
パラメーター
element:IGraphicElement — シーケンス内でこのエレメントの前のエレメントです。
|
Boolean — このエレメントがシーケンスの前のエレメントと互換性がある場合に true を返します。
|
関連する API エレメント
createDisplayObject | () | メソッド |
public function createDisplayObject():DisplayObject| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
この IGraphicElement が描画される新しい DisplayObject を作成します。
displayObject プロパティの getter に対する後続の呼び出しで、同じ表示オブジェクトを返す必要があります。
DisplayObject が作成された後、親の IGraphicElementContainer はシーケンスの残りのエレメントに表示オブジェクトを渡します。
IGraphicElementContainer では、必要な場合にのみ、このメソッドが呼び出されます。
エレメントが DisplayObject の共有に参加する必要がある場合、新しい DisplayObject は IShareableDisplayObject を実装する必要があります。このインターフェイスは、グラフィックエレメントのシーケンスの無効化と再描画を管理するために IGraphicElementContainer によって使用され、通常は開発者によって直接使用されることはありません。
共有シーケンスを再評価するには、IGraphicElementContainer に対して invalidateGraphicElementSharing() メソッドを呼び出します。
IGraphicElementContainer でエレメントの現在の DisplayObject を表示リストから削除し、表示オブジェクトの共有を再計算するには、IGraphicElementContainer に対して discardDisplayObject() メソッドを呼び出します。
DisplayObject — 作成される表示オブジェクトです.
|
関連する API エレメント
parentChanged | () | メソッド |
public function parentChanged(parent:IGraphicElementContainer):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
ホストコンポーネントに対して IGraphicElement が追加または削除された場合に IGraphicElementContainer によって呼び出されます。
通常はこのメソッドを呼び出す必要はありません。
パラメーター
parent:IGraphicElementContainer — この IGraphicElement の IGraphicElementContainer です。
|
setSharedDisplayObject | () | メソッド |
public function setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このエレメントがシーケンスの sharedDisplayObject に対して自分自身を描画できるかどうかを決定します。
通常、インプリメンターが true を返すのは、この IGraphicElement が共有 DisplayObject の graphics プロパティで累積的に描画を行うことができる場合です。この IGraphicElement が、シーケンスの残りのエレメントに適用されない DisplayObjects のプロパティを設定する必要がある場合、このメソッドは false を返す必要があります。このようなプロパティの例としては、回転、拡大 / 縮小、変換、マスク、アルファ、フィルター、カラー変換、3D、レイヤーなどがあります。
このメソッドが true を返す場合、displayObject プロパティの getter に対する後続の呼び出しで、同じ表示オブジェクトを返す必要があります。
場合によっては、sharedDisplayObject プロパティが IGraphicElementContainer 自体に設定されることもあります。 それ以外の場合、DisplayObject はシーケンスの最初のエレメントによって作成されます。
この IGraphicElement がシーケンスを再作成する必要がある場合、invalidateGraphicElementSharing() メソッドを呼び出すことにより、IGraphicElementContainer に通知します。
パラメーター
sharedDisplayObject:DisplayObject — 共有 DisplayObject です。
|
Boolean — この IGraphicElement がシーケンスの共有 DisplayObject に対して自分自身を描画できる場合に true を返します。
|
関連する API エレメント
validateDisplayList | () | メソッド |
public function validateDisplayList():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
displayObject プロパティのこのエレメントを再描画するために、IGraphicElementContainer によって呼び出されます。
エレメントがシーケンスの最初にある（displayObjectSharingMode が DisplayObjectSharingMode.OWNS_SHARED_OBJECT に設定されている）場合、残りのエレメントを描画するために、エレメントは displayObject グラフィックをクリアし、必要に応じて設定する必要があります。
validateDisplayList() メソッドが最後に呼び出された後、そのエレメント自体には変更がなくても、エレメントを再描画する必要があります。シーケンス内のいずれかのエレメントの再描画が必要になった場合、親の IGraphicElementContainer はシーケンス全体を再描画します。
このメソッドが確実に呼び出されるようにするには、invalidateGraphicElementSize() メソッドを呼び出すことによって IGraphicElementContainer に通知します。
このエレメントが IGraphicElementContainer に通知しない場合でも、このメソッドが呼び出される場合があります。
関連する API エレメント
validateProperties | () | メソッド |
public function validateProperties():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このエレメントのプロパティを検証するために IGraphicElementContainer によって呼び出されます。
このメソッドが確実に呼び出されるようにするには、invalidateGraphicElementProperties() メソッドを呼び出すことによって IGraphicElementContainer に通知します。
このエレメントが IGraphicElementContainer に通知しない場合でも、このメソッドが呼び出される場合があります。
関連する API エレメント
validateSize | () | メソッド |
public function validateSize():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 4 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このエレメントのサイズを検証するために IGraphicElementContainer によって呼び出されます。
エレメントのサイズが変化し、IGraphicElementContainer のレイアウトに影響する場合、インプリメンタが親のサイズと表示リストを無効にします。
このメソッドが確実に呼び出されるようにするには、invalidateGraphicElementSize() メソッドを呼び出すことによって IGraphicElementContainer に通知します。
このエレメントが IGraphicElementContainer に通知しない場合でも、このメソッドが呼び出される場合があります。
関連する API エレメント
Tue Jun 12 2018, 10:34 AM Z