| パッケージ | mx.core |
| クラス | public class UIComponentDescriptor |
| 継承 | UIComponentDescriptor  ComponentDescriptor Object |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
MXML ファイル内のほとんどのタグは、UIComponent オブジェクトのツリーを記述するものです。 例えば、<mx:Application> タグは UIComponent オブジェクトを表し、その子コンテナとコントロールもすべて UIComponent オブジェクトです。
MXML コンパイラーは、それぞれの MXML タグを UIComponentDescriptor インスタンスにコンパイルします。 厳密には、MXML コンパイラーは ActionScript データ構造を自動生成します。これは、UIComponentDescriptor オブジェクトのツリーになります。
実行時に、Container クラスの createComponentsFromDescriptors() メソッドは、コンテナの childDescriptors 配列の UIComponentDescriptor オブジェクト内の情報を使用して、コンテナの子である実際の UIComponent オブジェクト、およびその下位要素を作成します。 コンテナの creationPolicy プロパティの値によっては、アプリケーションの起動時にコンポーネントの一部が表示されるとき、またはアプリケーションの開発者が手動で createComponentsFromDescriptors() メソッドを呼び出したときに、下位要素が作成されることがあります。
通常、UIComponentDescriptor インスタンスを自分で作成することはありません。Container クラスの childDescriptors 配列を経由して、MXML コンパイラーが自動生成したインスタンスにアクセスできます。
関連する API エレメント
mx.core.Container.creationPolicy
mx.core.Container.createComponentsFromDescriptors()
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示| プロパティ | 定義元 | ||
|---|---|---|---|
 | 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 | |
| stylesFactory : Function
MXML に指定された、コンポーネントのインスタンススタイルの名前と値のペアを含むオブジェクトを作成する関数です。 | UIComponentDescriptor | ||
| type : Class
MXML に指定されたコンポーネントのクラスです。 | ComponentDescriptor | |
| メソッド | 定義元 | ||
|---|---|---|---|
UIComponentDescriptor(descriptorProperties:Object)
コンストラクターです。 | UIComponentDescriptor | ||
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
|
キャッシュされた properties プロパティを無効化します。 | ComponentDescriptor | |
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
"ComponentDescriptor_" および id プロパティの値を含むストリングを返します。 | ComponentDescriptor | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
effects | プロパティ |
public var effects:Array| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
MXML に指定された、コンポーネントのエフェクトを含む配列です。
例えば、次のようなコードを作成するとします。
<mx:TextInput showEffect="Fade" hideEffect="Fade"/>
記述子の effects プロパティは配列 [ "showEffect", "hideEffect" ] です。
コンポーネントに MXML エフェクトが指定されていない場合、effects プロパティは null になります。
このプロパティにはエフェクト属性の値は指定されていません。 エフェクトはスタイルのように扱われるため、stylesFactory プロパティに含まれます。 effect 配列は、stylesFactory のどのスタイルが実際にエフェクトになるのかを追跡するだけです。
Container の createComponentsFromDescriptors() メソッドは、このプロパティを使用して EffectManager にエフェクトを登録します。
stylesFactory | プロパティ |
public var stylesFactory:Function| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
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)| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | Flex 3 |
| ランタイムバージョン: | Flash Player 9, AIR 1.1 |
コンストラクターです。
パラメーターdescriptorProperties:Object — UIComponentDescriptor オブジェクトのプロパティ（type、id、propertiesFactory、events、stylesFactory、effects など）の名前と値のペアを含むオブジェクトです。
|
Tue Jun 12 2018, 10:34 AM Z