mx.core.UIComponentDescriptor （Flex 3.2）

パッケージ	mx.core
クラス	public class UIComponentDescriptor
継承	UIComponentDescriptor ComponentDescriptor Object

UIComponentDescriptor インスタンスは、ビジュアルコンポーネントのインスタンスの MXML タグに指定された情報をカプセル化します。

MXML ファイル内のほとんどのタグは、UIComponent オブジェクトのツリーを記述するものです。たとえば、<mx:Application> タグは UIComponent オブジェクトを表し、その子コンテナとコントロールもすべて UIComponent オブジェクトです。

MXML コンパイラは、それぞれの MXML タグを UIComponentDescriptor インスタンスにコンパイルします。厳密には、MXML コンパイラは ActionScript データ構造を自動生成します。これは、UIComponentDescriptor オブジェクトのツリーになります。

実行時に、Container クラスの createComponentsFromDescriptors() メソッドは、コンテナの childDescriptors 配列の UIComponentDescriptor オブジェクト内の情報を使用して、コンテナの子である実際の UIComponent オブジェクト、およびさらに深い子孫を作成します。コンテナのプロパティ creationPolicy の値によっては、アプリケーションの起動時にコンポーネントの一部が表示されるとき、またはアプリケーションの開発者が手動で createComponentsFromDescriptors() メソッドを呼び出したときに、子孫が作成されることがあります。

通常、UIComponentDescriptor インスタンスを自分で作成することはありません。Container クラスの childDescriptors 配列を経由して、MXML コンパイラが自動生成したインスタンスにアクセスできます。

パブリックプロパティ

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

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

	プロパティ		定義元
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		document : Object コンポーネントが作成されるドキュメントオブジェクトへの参照です。	ComponentDescriptor
		effects : Array MXML に指定された、コンポーネントのエフェクトを含む配列です。	UIComponentDescriptor
		events : Object MXML に指定された、コンポーネントのイベントハンドラの名前と値のペアを含むオブジェクトです。	ComponentDescriptor
		id : String MXML に指定されたコンポーネントの識別子です。	ComponentDescriptor
		properties : Object [読み取り専用] MXML に指定された、コンポーネントのプロパティの名前と値のペアを含むオブジェクトです。	ComponentDescriptor
		propertiesFactory : Function MXML に指定された、コンポーネントのプロパティの名前と値のペアを含むオブジェクトを返す関数です。	ComponentDescriptor
		prototype : Object [静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		stylesFactory : Function MXML に指定された、コンポーネントのインスタンススタイルの名前と値のペアを含むオブジェクトを作成する関数です。	UIComponentDescriptor
		type : Class MXML に指定されたコンポーネントのクラスです。	ComponentDescriptor

パブリックメソッド

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

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

	メソッド		定義元
		UIComponentDescriptor(descriptorProperties:Object) コンストラクタです。	UIComponentDescriptor
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		invalidateProperties():void キャッシュされた properties プロパティを無効化します。	ComponentDescriptor
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String "ComponentDescriptor_" および id プロパティの値を含むストリングを返します。	ComponentDescriptor
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

プロパティの詳細

effects

プロパティ

public var effects:Array

MXML に指定された、コンポーネントのエフェクトを含む配列です。

例えば、次のようなコードを作成するとします。

   <mx:TextInput showEffect="Fade" hideEffect="Fade"/>

記述子の effects プロパティは配列 [ "showEffect", "hideEffect" ] です。

コンポーネントに MXML エフェクトが指定されていない場合、effects プロパティは null になります。

このプロパティにはエフェクト属性の値は指定されていません。エフェクトはスタイルのように扱われるため、stylesFactory プロパティに含まれます。effect 配列は、stylesFactory のどのスタイルが実際にエフェクトになるのかを追跡するだけです。

Container メソッド createComponentsFromDescriptors() はこのプロパティを使用して EffectManager にエフェクトを登録します。

stylesFactory

プロパティ

public var stylesFactory:Function

MXML に指定された、コンポーネントのインスタンススタイルの名前と値のペアを含むオブジェクトを作成する関数です。

例えば、次のようなコードを作成するとします。

   <mx:TextInput borderColor="0x888888" color="0xDDDDDD"/>

この場合、記述子の stylesFactory プロパティは次の関数です。

   function():void { this.borderColor = 0x888888; this.color = 0xDDDDDD };

コンポーネントインスタンスに MXML スタイルが指定されていない場合、stylesFactory プロパティは null になります。

コンストラクタの詳細

UIComponentDescriptor

()

コンストラクタ

public function UIComponentDescriptor(descriptorProperties:Object)

コンストラクタです。

パラメータ

descriptorProperties:Object — UIComponentDescriptor オブジェクトのプロパティ、たとえば type、id、propertiesFactory、events、stylesFactory、effects などの名前と値のペアを含むオブジェクトです。

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/core/UIComponentDescriptor.html

Adobe® Flex™ 3.2 リファレンスガイド This Help system only	すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレームフレームなし
UIComponentDescriptor	プロパティ \| メソッド