パッケージ | mx.states |
クラス | public class AddChild |
継承 | AddChild OverrideBase OnDemandEventDispatcher Object |
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
overrides
プロパティで使用します。 creationPolicy
プロパティを使用して、アプリケーションの起動時またはビューステートへの変更時に子の作成を指定します。
子は、コンテナに追加されるまで creationComplete
イベントを送出しません。 例えば、以下のコードは Button コントロールをビューステート変更の一部として追加します。
<mx:AddChild relativeTo="{v1}"> <mx:Button id="b0" label="New Button"/> </mx:AddChild>
前の例で、Button コントロールはステートを変更し、Button コントロールがコンテナに追加されるまで creationComplete
イベントを送出しません。 AddChild クラスが Button とコンテナ(Canvas コンテナなど)の両方を定義する場合、Button コントロールは、作成されるときに creationComplete イベントを送出します。 例えば、creationPolicy
プロパティを all
に設定する場合、Button コントロールはアプリケーションの起動時にイベントを送出します。 creationPolicy
プロパティを auto
に設定する場合、Button コントロールは、ビューステートの変更時にイベントを送出します。
The <mx:AddChild>
tag
has the following attributes:
<mx:AddChild Properties target="null" targetFactory="null" creationPolicy="auto" position="lastChild" relativeTo="parent of the State object" />
デフォルトの MXML プロパティtargetFactory
関連する API エレメント
プロパティ | 定義元 | ||
---|---|---|---|
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
creationPolicy : String
この子の作成ポリシーです。 | AddChild | ||
position : String
relativeTo プロパティで指定されたオブジェクトを基準にした、表示リスト内での子の位置です。 | AddChild | ||
relativeTo : Object
このオブジェクトを基準として子が追加されます。 | AddChild | ||
target : DisplayObject
追加する子です。 | AddChild | ||
targetFactory : IDeferredInstance
子を作成するファクトリです。 | AddChild |
メソッド | 定義元 | ||
---|---|---|---|
コンストラクターです。 | AddChild | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | OnDemandEventDispatcher | ||
[オーバーライド]
オーバーライドを適用します。 | AddChild | ||
ファクトリから子インスタンスを作成します。 | AddChild | ||
イベントをイベントフローに送出します。 | OnDemandEventDispatcher | ||
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | OnDemandEventDispatcher | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
[オーバーライド]
IOverride インターフェイスのメソッド。このクラスは、このインターフェイスのメソッドを空のメソッドとして実装します。 | AddChild | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
[オーバーライド]
オーバーライドを削除します。 | AddChild | ||
EventDispatcher オブジェクトからリスナーを削除します。 | OnDemandEventDispatcher | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object | ||
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | OnDemandEventDispatcher |
creationPolicy | プロパティ |
creationPolicy:String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
この子の作成ポリシーです。 このプロパティは、いつ targetFactory
が子のインスタンスを作成するかを決定します。 targetFactory
プロパティを指定する場合にのみ、このプロパティが使用されます。 使用できる値は次のとおりです。
値 | 説明 |
---|---|
auto | (デフォルト)最初に必要になったときにインスタンスを作成します。 |
all | アプリケーションが起動したときにインスタンスを作成します。 |
none | インスタンスを自動的に作成しません。 インスタンスを作成するには、createInstance() メソッドを呼び出す必要があります。 |
デフォルト値: "auto"。
実装
public function get creationPolicy():String
public function set creationPolicy(value:String):void
position | プロパティ |
public var position:String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
relativeTo
プロパティで指定されたオブジェクトを基準にした、表示リスト内での子の位置です。 有効な値は、"before"
、"after"
、"firstChild"
および "lastChild"
です。
デフォルト値: "lastChild"。
relativeTo | プロパティ |
public var relativeTo:Object
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
このオブジェクトを基準として子が追加されます。 このプロパティは position
プロパティと一緒に使用します。 このプロパティはオプションです。省略する場合、State
オブジェクトの直接の親が使用されます。つまり、states
プロパティを持つコンポーネントまたは State オブジェクトを指定する <mx:states>
タグです。
target | プロパティ |
target:DisplayObject
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
追加する子です。 このプロパティを設定すると、アプリケーション起動時に子インスタンスが作成されます。 このプロパティを設定することは、targetFactory
プロパティを、creationPolicy
を "all"
として設定することと同じです。
targetFactory
プロパティを設定している場合は、このプロパティを設定しないでください。
実装
public function get target():DisplayObject
public function set target(value:DisplayObject):void
targetFactory | プロパティ |
targetFactory:IDeferredInstance
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
子を作成するファクトリです。 次のアイテムのいずれかを指定できます。
- IDeferredInstance インターフェイスを実装し、子インスタンスを作成するファクトリクラス。
- Button コントロールなどの Flex コンポーネント(UIComponent クラスのサブクラスとなるあらゆるクラス)。 Flex コンポーネントを使用する場合、Flex コンパイラーではファクトリクラス内でコンポーネントを自動的にラップします。
このプロパティを設定すると、子は creationPolicy
プロパティで決定された時点でインスタンス化されます。
targetFactory
プロパティを設定している場合は、このプロパティを設定しないでください。 このプロパティは、AddChild
クラスのデフォルトプロパティです。 このプロパティの creationPolicy
を "all" に設定することは、target
プロパティを設定することと同じです。
実装
public function get targetFactory():IDeferredInstance
public function set targetFactory(value:IDeferredInstance):void
AddChild | () | コンストラクター |
public function AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild")
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
コンストラクターです。
パラメーターrelativeTo:UIComponent (default = null ) — このコンポーネントを基準として子が追加されます。
| |
target:DisplayObject (default = null ) — 子オブジェクト。 すべての Flex コンポーネントは、DisplayObject クラスのサブクラスです。
| |
position:String (default = "lastChild ") — target の表示リスト内での位置で、relativeTo コンポーネントに関連しています。 "firstChild"、"lastChild"、"before" または "after" のいずれかになります。
|
apply | () | メソッド |
override public function apply(parent:UIComponent):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
オーバーライドを適用します。 Flex では元の値が保持されるため、後で remove()
メソッドに元の値を復元できます。
そのビューステートに移行すると、自動的にこのメソッドが呼び出されます。 このメソッドは直接呼び出さないでください。
パラメーター
parent:UIComponent — このオーバーライドを含むステートオブジェクトの親です。ターゲットが明示的に指定されていない場合、オーバーライドのターゲットとして使用されます。
|
createInstance | () | メソッド |
public function createInstance():void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ファクトリから子インスタンスを作成します。 targetFactory
プロパティおよび creationPolicy
値を "none"
に指定する場合のみ、このメソッドを使用する必要があります。 Flex では、creationPolicy
プロパティ値が "auto"
または "all"
の場合に、このメソッドを自動的に呼び出します。 このメソッドを複数回呼び出す場合、子インスタンスは最初の呼び出しでのみ作成されます。
initialize | () | メソッド |
override public function initialize():void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
IOverride インターフェイスのメソッド。このクラスは、このインターフェイスのメソッドを空のメソッドとして実装します。
remove | () | メソッド |
override public function remove(parent:UIComponent):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
オーバーライドを削除します。 apply()
メソッドに記憶されている値が復元されます。
そのビューステートに移行すると、自動的にこのメソッドが呼び出されます。 このメソッドは直接呼び出さないでください。
パラメーター
parent:UIComponent — このオーバーライドを含むステートオブジェクトの親です。ターゲットが明示的に指定されていない場合、オーバーライドのターゲットとして使用されます。
|
Tue Jun 12 2018, 10:34 AM Z