AddChild

パッケージ	mx.states
クラス	public class AddChild
継承	AddChild OverrideBase OnDemandEventDispatcher Object

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

AddChild クラスは、コンポーネントなどの子表示オブジェクトをビューステートの一部としてコンテナに追加します。このクラスは、State クラスの 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 コントロールは、ビューステートの変更時にイベントを送出します。

MXML シンタックス expanded

MXML シンタックスを隠す

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

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		creationPolicy : String この子の作成ポリシーです。	AddChild
		position : String relativeTo プロパティで指定されたオブジェクトを基準にした、表示リスト内での子の位置です。	AddChild
		relativeTo : Object このオブジェクトを基準として子が追加されます。	AddChild
		target : DisplayObject 追加する子です。	AddChild
		targetFactory : IDeferredInstance 子を作成するファクトリです。	AddChild

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild") コンストラクターです。	AddChild
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	OnDemandEventDispatcher
		apply(parent:UIComponent):void [オーバーライド] オーバーライドを適用します。	AddChild
		createInstance():void ファクトリから子インスタンスを作成します。	AddChild
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	OnDemandEventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		initialize():void [オーバーライド] IOverride インターフェイスのメソッド。このクラスは、このインターフェイスのメソッドを空のメソッドとして実装します。	AddChild
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		remove(parent:UIComponent):void [オーバーライド] オーバーライドを削除します。	AddChild
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この 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

コンストラクターの詳細

()

コンストラクター

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() メソッドに記憶されている値が復元されます。

そのビューステートに移行すると、自動的にこのメソッドが呼び出されます。このメソッドは直接呼び出さないでください。

パラメーター

法律上の注意 | プライバシーポリシー

AddChild - AS3 Flex

パッケージx

言語エレメント

付録

パッケージ mx.states

creationPolicy

position

relativeTo

target

targetFactory

AddChild

apply

createInstance

initialize

remove