コンポーネントのテキストの 1 行目のベースライン y 座標を指定します。このプロパティは、各コンポーネントによってオーバーライドされます。

オブジェクトのビットマップキャッシュを提案するために Flex によって使用されます。cachePolicy が UIComponentCachePolicy.AUTO の場合、オブジェクトの cacheAsBitmap プロパティをコントロールするために、cacheHeuristic が使用されます。

このオブジェクトのビットマップキャッシュポリシーを指定します。MXML で有効な値は、"on"、"off"、"auto" (デフォルト) です。

ActionScript で有効な値は、UIComponentCachePolicy.ON、UIComponentCachePolicy.OFF、UIComponentCachePolicy.AUTO (デフォルト) です。

• 値が UIComponentCachePolicy.ON の場合、オブジェクトは常にビットマップとしてキャッシュされます。
• 値が UIComponentCachePolicy.OFF の場合、オブジェクトはビットマップとしてキャッシュされません。
• 値が UIComponentCachePolicy.AUTO の場合、フレームワークはヒューリスティックを使用してオブジェクトをビットマップとしてキャッシュするかどうかを判断します。

デフォルト値UIComponentCachePolicy.AUTO.

このインスタンスのクラス名です。たとえば、"Button" などがあります。

このストリングにはパッケージ名は含まれません。パッケージ名も必要な場合は、flash.utils パッケージの getQualifiedClassName() メソッドを呼び出してください。"mx.controls::Button" のようなストリングが返されます。

コンテンツ座標系におけるマウスの x 位置を返します。コンテンツ座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。現在切り詰められていて、アクセスするにはコンポーネントをスクロールすることが必要な領域も含め、コンポーネントのすべてのコンテンツ領域を含みます。

コンテンツ座標系におけるマウスの y 位置を返します。コンテンツ座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。現在切り詰められていて、アクセスするにはコンポーネントをスクロールすることが必要な領域も含め、コンポーネントのすべてのコンテンツ領域を含みます。

コンポーネントの現在のビューステートです。コンポーネントをベースステートにリセットするには、"" または null に設定します。

このプロパティを使用してコンポーネントの状態を設定すると、Flex は定義されたトランジションを適用します。setCurrentState() メソッドを使用して現在の状態を設定することもできます。このメソッドは、トランジションを適用することなくオプションで状態を変更できます。

このプロパティはデータバインディングのソースとして使用できます。

関連項目

この UIComponent インスタンスの作成のために createComponentFromDescriptor() メソッドで使用した UIComponentDescriptor への参照です (存在する場合)。この UIComponent インスタンスが記述子から作成されていない場合、このプロパティは null です。

関連項目

この UIComponent に関連付けられたドキュメントオブジェクトへの参照です。ドキュメントオブジェクトは、Flex アプリケーション、MXML コンポーネント、または AS コンポーネントの階層の最上位にあるオブジェクトです。

UIComponent オブジェクトが doubleClick イベントを受け取るかどうかを指定します。デフォルト値は true です。これは、UIComponent オブジェクトが doubleClick イベントを受け取ることを意味します。

オブジェクトが doubleClick イベントを受け取るようにするには、mouseEnabled プロパティもデフォルト値の true に設定する必要があります。

デフォルト値true.

コンポーネントがユーザーの操作を受け入れることができるかどうかを指定します。あるコンテナに対して enabled プロパティを false に設定すると、そのコンテナとそのすべての子がグレー表示になり、それらのコンテナと子には入力できなくなります。

このプロパティはデータバインディングのソースとして使用できます。

バリデータによってコンポーネントを監視しているとき、検証が失敗した場合に、そのコンポーネントのエラーヒントに表示されるテキストです。

Validator クラスを実際に使用しないで検証エラーを表示するには、errorString プロパティを使用します。errorString プロパティにストリング値を書き込むと、検証エラーを示すためにコンポーネントの周りに赤い境界線が描画されます。バリデータが検証エラーを検出した場合と同様に、マウスポインタをコンポーネント上に重ねると、ツールヒントに検証エラーメッセージとしてそのストリングが表示されます。

検証エラーをクリアするには、errorString プロパティに空のストリング ("") を指定します。

errorString プロパティに値を書き込んでも、valid または invalid イベントはトリガされません。単に、境界線の色が変更され、検証エラーメッセージが表示されるだけです。

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの座標内におけるコンポーネントの明示的な高さ (ピクセル単位) を指定する数値です。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の explicitHeight は、scaleY プロパティの影響を受けます。

height プロパティを設定すると、このプロパティも高さの指定値に設定されます。

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの座標内におけるコンポーネントの最大の高さ (ピクセル単位) を指定する数値です。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の maxHeight は、scaleY プロパティの影響を受けます。高さに理論上の制限を持たないコンポーネントもあります。これらの場合は、それぞれの maxHeight が UIComponent.DEFAULT_MAX_HEIGHT に設定されます。

デフォルト値NaN.

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの座標内におけるコンポーネントの最大の幅 (ピクセル単位) を指定する数値です。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の maxWidth は、scaleX プロパティの影響を受けます。幅に理論上の制限を持たないコンポーネントもあります。これらの場合は、それぞれの maxWidth が UIComponent.DEFAULT_MAX_WIDTH に設定されます。

デフォルト値NaN.

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの座標内におけるコンポーネントの最小の高さ (ピクセル単位) を指定する数値です。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の minHeight は、scaleY プロパティの影響を受けます。

デフォルト値NaN.

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの座標内におけるコンポーネントの最小の幅 (ピクセル単位) を指定する数値です。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の minWidth は、scaleX プロパティの影響を受けます。

デフォルト値NaN.

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの座標内におけるコンポーネントの明示的な幅 (ピクセル単位) を指定する数値です。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の explicitWidth は、scaleX プロパティの影響を受けます。

width プロパティを設定すると、このプロパティも幅の指定値に設定されます。

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントが、クリックされたときにフォーカスを受け付けられるかどうかを示します。このプロパティが false の場合、フォーカスは mouseFocusEnable が true に設定された最初の親に転送されます。

デフォルト値true.

このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得します。ポップアップは、それぞれ独自のフォーカスループを持ち、その結果、それぞれ FocusManager の独自のインスタンスを持ちます。間違いなく目的のオブジェクトを扱うためには、このメソッドを使用します。

このオブジェクトに関連付けられたフォーカスペインです。オブジェクトの子のいずれにフォーカスがあると、オブジェクトはフォーカスペインを持ちます。

親の座標内におけるコンポーネントの高さ (ピクセル単位) を指定する数値です。デフォルト値は 0 であり、コントロールの実際の高さではありません。

メモ:MXML の height 属性には height="100%" のようにパーセンテージ値を指定できますが、ActionScript の height プロパティにはパーセンテージ値を使用できません。その代わりに、percentHeight プロパティを使用してください。

このプロパティを設定すると、resize イベントが送出されます。このイベントがどのような場合に送出されるかについては、resize イベントの説明を参照してください。コンポーネントの scaleY プロパティが 100 以外の場合は、コンポーネントの内部座標における高さとは一致しません。したがって、scaleY が 200 で高さが 100 ピクセルのコンポーネントは、親においては 100 ピクセルを占めますが、内部では高さ 50 ピクセルと見なされます。

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの ID です。この値はオブジェクトのインスタンス名になります。この値には、空白または特殊文字を含めるべきではありません。アプリケーション全体で、各コンポーネントが固有の ID を持つ必要があります。

サードパーティ製のツールを使用してアプリケーションをテストする場合は、各コンポーネントに意味のある ID を与えます。テストツールはスクリプトの中で ID を使用してコントロールを表すため、意味のある名前を付けておくとスクリプトが読みやすくなります。たとえば、ボタンの値には、b1 や button1 ではなく、submit_button を使用します。

このコンポーネントを親コンテナのレイアウトに含めるかどうかを指定します。true の場合、オブジェクトは親コンテナのレイアウトに含まれます。false の場合、オブジェクトはそのレイアウト規則に従って親コンテナによって位置付けられますが、次の子の位置の計算では無視されます。

デフォルト値true.

このプロパティはデータバインディングのソースとして使用できます。

このコンポーネントの継承スタイルのチェーンの始まりです。getStyle() メソッドは単純に inheritingStyles[styleName] にアクセスして、プロトタイプリンクのチェーン全体を検索します。このオブジェクトは initProtoChain() によって設定されます。開発者は通常このプロパティに直接アクセスする必要はありません。

オブジェクトがレイアウトの以下の 3 つの段階をすべて完了したものであるかどうかを示すフラグです。処理、測定、およびレイアウト (いずれかの段階が必須であった場合)。

繰り返されるコンポーネントのインデックスです。コンポーネントが Repeater 内にない場合、この値は -1 になります。

この UIComponent オブジェクトを親ドキュメントから参照するために必要なインデックスを含む配列です。この UIComponent オブジェクトが他の Repeater に含まれていない限り、この配列は空です。最初のエレメントが最も外側の Repeater を表します。たとえば、ID が "b" で instanceIndices が [2,4] の場合、親のドキュメント上で r[2][4] として参照します。

この UIComponent インスタンスがドキュメントオブジェクトであるか、つまり Flex アプリケーション、MXML コンポーネント、または ActionScript コンポーネントの階層の最上位に位置するかどうかを指定します。

コンポーネントがポップアップされたことを示すため、PopUpManager によって true に設定されます。

コンポーネントの座標内におけるコンポーネントの最大の高さ (ピクセル単位) を指定する数値です。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の maxHeight は、scaleY プロパティの影響を受けます。高さに理論上の制限を持たないコンポーネントもあります。これらの場合は、それぞれの maxHeight が UIComponent.DEFAULT_MAX_HEIGHT に設定されます。

デフォルト値10000.

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの座標内におけるコンポーネントの最大の幅 (ピクセル単位) を指定する数値です。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の maxWidth は、scaleX プロパティの影響を受けます。幅に理論上の制限を持たないコンポーネントもあります。これらの場合は、それぞれの maxWidth が UIComponent.DEFAULT_MAX_WIDTH に設定されます。

デフォルト値10000.

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントのデフォルトの高さです (ピクセル単位)。この値は measure() メソッドによって設定されます。

コンポーネントのデフォルトの最小高さです (ピクセル単位)。この値は measure() メソッドによって設定されます。

コンポーネントのデフォルトの最小幅です (ピクセル単位)。この値は measure() メソッドによって設定されます。

コンポーネントのデフォルトの幅です (ピクセル単位)。この値は measure() メソッドによって設定されます。

コンポーネントの座標内におけるコンポーネントの最小の高さ (ピクセル単位) を指定する数値です。デフォルト値は、コンポーネントの実装に依存します。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の minHeight は、scaleY プロパティの影響を受けます。

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの座標内におけるコンポーネントの最小の幅 (ピクセル単位) を指定する数値です。デフォルト値は、コンポーネントの実装に依存します。

この値は、コンポーネントのサイズと位置を計算するためにコンテナで使用されます。コンポーネントのデフォルトのサイズを決定するために、コンポーネント自体で使用されることはありません。したがって、Container、またはこのプロパティを計算に使用しないコンテナが親である場合、このプロパティは機能しません。値はコンポーネント座標内におけるものなので、親に対する実際の minWidth は、scaleX プロパティの影響を受けます。

このプロパティはデータバインディングのソースとして使用できます。

クリックしたとき、フォーカスを受け付けられるかどうかを示します。false の場合、フォーカスは mouseFocusEnable が true に設定された最初の親に転送されます。

デフォルト値true.

オブジェクト階層におけるこのオブジェクトの深度を表します。この数値は、測定およびレイアウトコードによって使用されます。このコンポーネントが DisplayList でない場合、この値は 0 になります。

このコンポーネントの非継承スタイルのチェーンの始まりです。getStyle() メソッドは単純に nonInheritingStyles[styleName] にアクセスして、プロトタイプリンクのチェーン全体を検索します。このオブジェクトは initProtoChain() によって設定されます。開発者は通常このプロパティに直接アクセスする必要はありません。

この UIComponent のオーナー。デフォルトでは、この UIComponent の親です。ただし、この UIComponent オブジェクトが、ComboBox コントロールのドロップダウンリストのように、親によってポップアップされた子コンポーネントである場合は、この UIComponent オブジェクトをポップアップしたコンポーネントがオーナーになります。

このプロパティは、Flex ではなく、各コンポーネントによって管理されます。したがって、PopUpManger.createPopUp() または PopUpManger.addPopUp() メソッドを使用して子コンポーネントをポップアップする場合は、子コンポーネントの owner プロパティを、それをポップアップしたコンポーネントに設定する必要があります。

デフォルト値は、parent プロパティの値です。

このコンポーネントの親コンテナまたは親コンポーネントです。親プロパティを持つのは UIComponent オブジェクトのみであることが必要です。非 UIComponent オブジェクトは、所属するオブジェクトを参照するには別のプロパティを使用する必要があります。慣例により、非 UIComponent オブジェクトは、所属するオブジェクトを参照するには owner プロパティを使用します。

この UIComponent インスタンスを含む Application オブジェクトへの参照です。この Application オブジェクトが別の Application の SWFLoader コントロールに存在する、というつながりが続く形で、Application オブジェクトのチェーンを作成できます。このチェーンは、parentApplication を使用して移動することができます。Application オブジェクトの parentApplication プロパティはそれ自体の参照ではなく、ロード先の Application オブジェクトか、または null (最上位レベルの Application の場合) となります。parentApplication プロパティを使用してアプリケーションチェーン内を移動する操作は、parentDocument プロパティを使用してドキュメントチェーン内を移動する操作に似ています。トップレベルアプリケーションにアクセスするには、Application クラスの application プロパティを使用します。

このプロパティはデータバインディングのソースとして使用できます。

この UIComponent に対する親ドキュメントオブジェクトへの参照です。ドキュメントオブジェクトは、Flex アプリケーション、MXML コンポーネント、または AS コンポーネントの階層の最上位にある UIComponent です。Application オブジェクトの場合、parentDocument プロパティは null です。このプロパティは、MXML スクリプトで、ドキュメントオブジェクトチェーンの上のレベルに移動するのに役立ちます。parentDocument.parentDocument などを使用して、このチェーンを移動するのに使用できます。parentObject は Object 型なので、作成者はキャストすることなく、祖先ドキュメントオブジェクトのプロパティおよびメソッドにアクセスできます。

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの高さを親のサイズに対する比率 (パーセンテージ) で指定する数値です。有効な値は 0 ～ 100 です。デフォルト値は NaN です。height または explicitHeight プロパティを設定すると、このプロパティが NaN にリセットされます。

このプロパティは、前に設定されている場合にのみ数値を返します。コンポーネントの正確なサイズをパーセンテージで示しているわけではありません。

このプロパティはデータバインディングのソースとして使用できます。

コンポーネントの幅を親のサイズに対する比率 (パーセンテージ) で指定する数値です。有効な値は 0 ～ 100 です。デフォルト値は NaN です。width または explicitWidth プロパティを設定すると、このプロパティが NaN にリセットされます。

このプロパティは、前に設定されている場合にのみ数値を返します。コンポーネントの正確なサイズをパーセンテージで示しているわけではありません。

このプロパティはデータバインディングのソースとして使用できます。

子をすぐに生成するか、遅延生成した後、このいずれかの発生に応じて、true に設定されます。Container オブジェクトの場合、これは createComponentsFromDescriptors() メソッドの末尾で true に設定されます。つまり、子の作成は、Container オブジェクトが子の記述子から子を作成した後に行われることを意味します。

たとえば、Accordion コンテナが遅延インスタンス化を使用する場合、Accordion コンテナの 2 番目のペインの processedDescriptors プロパティは、ユーザーがそのペインまでナビゲートし、ペインがその子を作成するまで true になりません。ただし、Accordion が creationPolicy プロパティを "all" に設定している場合、その 2 番目のペインの processedDescriptors プロパティはアプリケーションの起動中に true に設定されます。

コンテナではないクラスには記述子がなく、この場合、プロパティは createChildren() メソッドが内部コンポーネントの子を作成した後に true に設定されます。

この UIComponent を作成した Repeater オブジェクト (親ドキュメント内にある) への参照です。UIComponent が 1 つの Repeater オブジェクトによって作成される場合は、repeaters プロパティではなく、このプロパティを使用します。この UIComponent がネストされた Repeater オブジェクトによって作成される場合は、repeaters プロパティを使用します。

この UIComponent が Repeater によって作成されない場合、このプロパティは null に設定されます。

この UIComponent を作成した Repeater のデータプロバイダ内にあるアイテムのインデックスです。UIComponent が 1 つの Repeater オブジェクトによって作成される場合は、repeaterIndices プロパティではなく、このプロパティを使用します。この UIComponent がネストされた Repeater オブジェクトによって作成される場合は、repeaterIndices プロパティを使用します。

この UIComponent が Repeater によって作成されない場合、このプロパティは -1 に設定されます。

この UIComponent を生成した、親ドキュメント内にある Repeater のデータプロバイダに含まれるアイテムのインデックスを含む配列です。この UIComponent が他の Repeater に含まれていない限り、この配列は空です。

配列の最初のエレメントが最も外側の Repeater を表します。たとえば、repeaterIndices が [2,4] の場合は、外部リピーターがアイテム dataProvider[2] を使用し、内部リピーターがアイテム dataProvider[4] を使用したことを意味します。

いずれかの Repeater の startingIndex プロパティが 0 以外の場合、このプロパティは instanceIndices プロパティと異なります。たとえば、Repeater が dataProvider[4] から開始する場合も、最初に繰り返されるオブジェクトのドキュメント参照は b[4] ではなく b[0] です。

この UIComponent を作成した Repeater オブジェクト (親ドキュメント内にある) への参照を含む配列です。この UIComponent が他の Repeater に含まれていない限り、この配列は空です。最初のエレメントが最も外側の Repeater オブジェクトを表します。

水平方向の拡大 / 縮小の比率を指定する数値です。

デフォルト値は 1.0 で、オブジェクトは拡大/縮小されていない状態です。scaleX が 2.0 の場合は、オブジェクトが 2 倍に拡大されています。scaleX が 0.5 の場合は、オブジェクトが 2 分の 1 に縮小されています。

値 0.0 は無効です。コンポーネントを非表示にするには、0.0 に設定せずに、小さい値に設定するか、visible プロパティを false に設定します。

デフォルト値1.0.

このプロパティはデータバインディングのソースとして使用できます。

垂直方向の伸縮率を指定する数値です。

デフォルト値は 1.0 で、オブジェクトは拡大/縮小されていない状態です。scaleY が 2.0 の場合は、オブジェクトが 2 倍に拡大されています。scaleY が 0.5 の場合は、オブジェクトが 2 分の 1 に縮小されています。

値 0.0 は無効です。コンポーネントを非表示にするには、0.0 に設定せずに、小さい値に設定するか、visible プロパティを false に設定します。

デフォルト値1.0.

このプロパティはデータバインディングのソースとして使用できます。

このオブジェクトの基本的な描画面のサイズと位置を含むオブジェクトを返します。

このコンポーネントに対して定義されたビューステート。states プロパティを指定できるのは、アプリケーションのルートまたは MXML コンポーネントのルートタグに限られます。このプロパティをそれ以外のコントロールに指定すると、コンパイルエラーになります。

このオブジェクトのインラインの継承スタイルの記憶域です。この CSSStyleDeclaration は、継承スタイルを設定するためにこのコンポーネントで初めて setStyle() メソッドが呼び出されたときに作成されます。開発者は通常このプロパティに直接アクセスする必要はありません。

このコンポーネントで使用するクラススタイル。ストリング、CSSStyleDeclaration、IStyleClient のいずれかを使用できます。

ストリングの場合、この値は mx:Style タグ内のクラス宣言の名前または CSS ファイルの名前です。styleName にはピリオドを含めません。たとえば、".bigText" という名前のクラススタイルの場合は、styleName プロパティを "bigText" (ピリオドなし) に設定します。

これが IStyleClient (通常は UIComponent) の場合は、styleName オブジェクト内のすべてのスタイルがこのコンポーネントに使用されます。

デフォルト値null.

このコンポーネントで使用する SystemManager オブジェクトを返します。

ツールヒントに表示するテキストです。

デフォルト値null.

このプロパティはデータバインディングのソースとして使用できます。

Transition オブジェクトの配列です。各 Transition オブジェクトには、ビューステートが変化したときに再生されるエフェクトのセットが定義されます。

関連項目

このオブジェクトに対して現在トゥイーンされているプロパティの配列。

このオブジェクトの一部のプロパティがトゥイーンされることを EffectManager に警告して、EffectManger が同じプロパティのアニメーション化を試みないようにします。

オブジェクトの一意の識別子です。Flex データ駆動型コントロールは、List クラスのサブクラスであるすべてのコントロールも含めて、UID を使用してデータプロバイダのアイテムを追跡します。

Flex は UID を自動的に作成および管理できます。ただし、環境によっては、IUID インターフェイスを実装して独自の uid プロパティを指定することが必要になる場合、または独自の uid プロパティを指定すると処理効率が向上する場合があります。Flex で使用される UID はほとんどの場合全体的に一意である必要はありません。例外はデータサービスによって送信されるメッセージの場合です。

関連項目

拡大 / 縮小なしのコンポーネントの高さを求める便利なメソッドです。コンポーネントの描画および子のレイアウトはすべて、この高さの四角い枠内で行う必要があります。また、この値は updateDisplayList() に引数として渡されます。

拡大 / 縮小なしのコンポーネントの幅を求める便利なメソッドです。コンポーネントの描画および子のレイアウトはすべて、この幅の四角い枠内で行う必要があります。また、この値は updateDisplayList() に引数として渡されます。

オブジェクトが 3 段階のレイアウト検証を完了したものであるかどうかを示すフラグです (いずれかの検証が必須であった場合)。

このコンポーネントにサブフィールドを関連付けるためにバリデータによって使用されます。

この UIComponent の可視性を制御します。true の場合、オブジェクトは可視です。

true に設定すると、オブジェクトが show イベントを送出します。false に設定すると、オブジェクトが hide イベントを送出します。いずれの場合も、特に実装されていない限り、オブジェクトの子は show イベントも hide イベントも生成しません。

デフォルト値true.

このプロパティはデータバインディングのソースとして使用できます。

親の座標内におけるコンポーネントの幅 (ピクセル単位) を指定する数値です。デフォルト値は 0 であり、コントロールの実際の幅ではありません。

メモ:MXML の width 属性には width="100%" のようにパーセンテージ値を指定できますが、ActionScript の width プロパティではパーセンテージ値は使用できません。このプロパティの代わりに、percentWidth プロパティを使用してください。

このプロパティを設定すると、resize イベントが送出されます。このイベントがどのような場合に送出されるかについては、resize イベントの説明を参照してください。コンポーネントの scaleX プロパティが 1.0 以外の場合は、コンポーネントの内部座標における幅とは一致しません。したがって、scaleX が 2 で幅が 100 ピクセルのコンポーネントは、親においては 100 ピクセルを占めますが、内部では幅 50 ピクセルと見なされます。

このプロパティはデータバインディングのソースとして使用できます。

親コンテナ内におけるコンポーネントの水平位置 (ピクセル単位) を指定する数値です。

コンポーネントの親が HBox、Grid、Form などの相対レイアウトコンテナである場合、このプロパティを直接または move() の呼び出しにより設定しても、無効になるか、または一時的にしか有効になりません。これは、これらのコンテナの x 位置が、レイアウト計算によって設定されるためです。ただし、親が Canvas などの絶対配置コンテナである場合は、デフォルト値が 0 であるため、x プロパティを常に設定する必要があります。

デフォルト値0.

このプロパティはデータバインディングのソースとして使用できます。

親コンテナ内におけるコンポーネントの垂直位置 (ピクセル単位) を指定する数値です。

コンポーネントの親が HBox、Grid、Form などの相対レイアウトコンテナである場合、このプロパティを直接または move() の呼び出しにより設定しても、無効になるか、または一時的にしか有効になりません。これは、これらのコンテナの x 位置が、レイアウト計算によって設定されるためです。ただし、親が Canvas などの絶対配置コンテナである場合は、デフォルト値が 0 であるため、x プロパティを常に設定する必要があります。

デフォルト値0.

このプロパティはデータバインディングのソースとして使用できます。

コンストラクタ。

フォーカス矩形を調整します。

これは、Flex フレームワークが Dissolve エフェクトをサポートするために使用する内部メソッドです。このメソッドを呼び出す必要はなく、オーバーライドする必要もありません。

後で呼び出す関数をキューに格納します。

画面を毎回更新する前に、Flash Player は更新が予定されている関数のセットを呼び出します。場合によっては、現在の更新に予定されているすべてのコードを実行するために、特定の関数を次の更新で呼び出す必要があります。エフェクトなど一部の機能では、その機能が完了するまで、キューに格納された関数を表示することができます。

子オブジェクトの作成後に行われる最終処理を実行します。これは、UIComponent のサブクラスを作成するときにオーバーライド可能な高度なメソッドです。

このコンポーネントインスタンスからスタイルプロパティを削除します。

getStyle() メソッドは、必ずしも undefined を返すわけではありません。

コンポーネントに設定されたプロパティを処理します。これは、UIComponent のサブクラスを作成するときにオーバーライド可能な高度なメソッドです。

このメソッドは直接呼び出さないでください。addChild() メソッドを使用してコンポーネントがコンテナに追加されたとき、またはコンポーネントの invalidateProperties() メソッドが呼び出されたときに、Flex により commitProperties() メソッドが呼び出されます。commitProperties() メソッドの呼び出しは、measure() メソッドの呼び出しの前に実行されます。このため、measure() メソッドが使用する可能性のあるプロパティの値を設定することができます。

一部のコンポーネントには、作成する必要のある子オブジェクトの数や種類に影響するプロパティがあります。また、horizontalScrollPolicy や horizontalScrollPosition のように相互に作用し合うプロパティを持つコンポーネントもあります。多くの場合、作業の重複や一部の値の無視を避けるため、起動時にこれらのプロパティを一度に処理することが最善です。

関連項目

Point オブジェクトをコンテンツ座標からグローバル座標に変換します。コンテンツ座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。現在切り詰められていて、アクセスするにはコンポーネントをスクロールすることが必要な領域も含め、コンポーネントのすべてのコンテンツ領域を含みます。コンテンツ座標系を使用して、絶対配置を使用しているコンテナの子の配置を設定および取得します。グローバル座標では、Flash Player のステージの左上隅、つまりアプリケーションの最も外側の端を基準としたピクセル位置を指定します。

関連項目

Point オブジェクトをコンテンツ座標からローカル座標に変換します。コンテンツ座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。現在切り詰められていて、アクセスするにはコンポーネントをスクロールすることが必要な領域も含め、コンポーネントのすべてのコンテンツ領域を含みます。コンテンツ座標系を使用して、絶対配置を使用しているコンテナの子の配置を設定および取得します。ローカル座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。

関連項目

コンポーネントの子オブジェクトを作成します。これは、UIComponent のサブクラスを作成するときにオーバーライド可能な高度なメソッドです。

内部に他のコンポーネントやオブジェクトを作成するコンポーネントは、複合コンポーネントと呼ばれます。たとえば、Flex ComboBox コントロールは実際に、ComboBox のテキスト領域を定義する TextInput コントロールと ComboBox の矢印 を定義する Button コントロールから構成されます。コンポーネントで createChildren() メソッドを実装するのは、コンポーネント内で他のコンポーネントなどの子オブジェクトを作成するためです。

createChildren() メソッドのオーバーライド内から addChild() メソッドを呼び出してそれぞれの子オブジェクトを追加します。

このメソッドは直接呼び出さないでください。コンポーネントをその親に追加する addChild() メソッドの呼び出しに応じて、createChildren() メソッドが呼び出されます。

関連項目

この IUIComponent オブジェクトへの id 参照を親ドキュメントオブジェクト上に作成します。この関数は、b[2][4] のように複数の Repeater 内にあるオブジェクトに対する多次元参照を作成できます。インデックスが null の場合は、単純な、配列ではない参照を作成します。

この IUIComponent オブジェクトへの id 参照を親ドキュメントオブジェクトから削除します。この関数は、b[2][4] のように複数の Repeater 内にあるオブジェクトに対する多次元参照を削除できます。インデックスが null の場合は、単純な、配列ではない参照を削除します。

この UIComponent のテキストスタイルに対応する UITextFormat オブジェクトを返します。

このコンポーネントを囲むフォーカスインジケータを表示または非表示にします。

UIComponent は、focusSkin スタイルに指定されたクラスのインスタンスを作成し、適切に配置することにより、これを実装します。

このスキンの Graphics オブジェクトに、プログラムで矩形を描画します。

矩形の角を丸くすることができます。矩形の端は、Graphics オブジェクトの現在の線スタイルによりストロークを設定できます。単色またはグラデーションの塗りを適用することもできますし、塗りを適用しなくてもかまいません。単色の塗りには、アルファ透明度を適用できます。グラデーションの塗りは線状または放射状にできます。グラデーションに沿った指定の点で、最大 15 のカラーとアルファ値を指定できます。さらにグラデーションの回転角度または変換行列を指定できます。最後に、矩形には丸い矩形の空洞を彫り込むことができます。

この多用途の矩形描画ルーチンは、さまざまなスキンで使用されます。このルーチンでは、このスキンの Graphics オブジェクトに描画するために、(flash.display.Graphics クラス内の) drawRect() メソッドまたは drawRoundRect() メソッドを呼び出します。

コンポーネントでの再生の停止時にエフェクトインスタンスによって呼び出されます。このメソッドを使用すると、エフェクトの終了時に、effectStarted() メソッドによってエフェクトの開始時に行われたコンポーネントに対する変更を復元すること、またはその他のアクションを実行することができます。

コンポーネントでの再生の開始時にエフェクトインスタンスによって呼び出されます。このメソッドを使用して、エフェクトの一部としてコンポーネントの変更を実行することができます。effectFinished() メソッドを使用して、エフェクトの終了時に変更を復元することができます。

現在コンポーネントで再生中のすべてのエフェクトを終了します。

この UIComponent オブジェクトへのデータバインディングを実行します。

印刷の完了後に呼び出されます。UIComponent クラスの場合、このメソッドはアクションを実行しません。Flex コンテナはこのメソッドをオーバーライドし、印刷の後にコンテナを復元します。

アプリケーション開発者は通常このメソッドを使用しません。

関連項目

UIComponent オブジェクトがフォーカスを取得したときに呼び出されるイベントハンドラです。このメソッドをオーバーライドする場合は、必ず基本クラスのバージョンを呼び出してください。

UIComponent オブジェクトがフォーカスを失ったときに呼び出されるイベントハンドラです。このメソッドをオーバーライドする場合は、必ず基本クラスのバージョンを呼び出してください。

この UIComponent インスタンスのタイプセレクタを探します。このアルゴリズムは、スーパークラスチェーンをたどります。たとえば、MyButton クラスが Button を拡張するとします。MyButton インスタンスはまず MyButton タイプセレクタを探し、次に Button タイプセレクタを、さらに UIComponent タイプセレクタを探します。(スーパークラスチェーンは、オブジェクトではなく、UIComponent で停止すると見なされます)。

明示された高さを使用するのか、それとも測定した高さを使用するのかを決定する便利なメソッドです。

明示的な幅または測定幅を使用するかどうかを決定するための便利なメソッドです。

現在フォーカスを持っているオブジェクトを取得します。今扱っているオブジェクトにはフォーカスがない可能性があります。ただし、必ずしもフォーカスを持っているコンポーネントが返されるとは限りません。フォーカスを持っているコンポーネントの内部サブコンポーネントが返されることがあります。フォーカスを持っているコンポーネントを取得するには、focusManager.focus プロパティを使用します。

指定された Repeater がこの Repeater を生成するために使用した dataProvider 内のアイテムを返します。この Repeater が繰り返されていない場合は、null を返します。引数 whichRepeater は、最も外側の Repeater が 0、次に内側の Repeater が 1 になり、以降も同様に続きます。whichRepeater が指定されていない場合は、最も内側の Repeater が使用されます。

このコンポーネントのスタイル参照チェーンのいずれかの場所に設定されたスタイルプロパティを取得します。

この同じメソッドを使用して任意の種類のスタイルプロパティを取得するため、戻り値はBoolean、String、Number、int、uint (RGB カラーの場合)、Class (スキンの場合)、または何らかのオブジェクトになります。したがって、戻り値の型は単に以下のように指定されます。

特定のスタイルプロパティを取得している場合は、その型を認識し、その型の変数に結果を保存することがよくあります。その型から、またはその型へのキャストは必要ありません。

var backgroundColor:uint = getStyle("backgroundColor");

スタイルプロパティがスタイル参照チェーンのどこにも設定されていない場合は、getStyle() によって返される値は undefined になります。undefined は、false, ""、NaN、0、または null とは異なる特殊な値である点に注意してください。有効なスタイル値が undefined になることはありません。値が設定されたかどうかをテストするには、静的メソッド StyleManager.isValidStyleValue() を使用します。

関連項目

Point オブジェクトをグローバル座標からコンテンツ座標に変換します。グローバル座標では、Flash Player のステージの左上隅、つまりアプリケーションの最も外側の端を基準としたピクセル位置を指定します。コンテンツ座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。現在切り詰められていて、アクセスするにはコンポーネントをスクロールすることが必要な領域も含め、コンポーネントのすべてのコンテンツ領域を含みます。コンテンツ座標系を使用して、絶対配置を使用しているコンテナの子の配置を設定および取得します。

関連項目

水平方向のグラデーションを描画するときに rot パラメータとして drawRoundRect() メソッドに渡すことのできるボックスの Matrix を返します。

パフォーマンスのために、Matrix は静的変数に保存され、horizontalGradientMatrix() および verticalGradientMatrix() に対するすべての呼び出しで再使用されます。したがって、horizontalGradientMatrix() または verticalGradientMatrix() を再度呼び出す前に、この Matrix を drawRoundRect() に渡す必要があります。

このコンポーネントの初期化を完了させます。

このメソッドは、addChild() または addChildAt() を使用してコンポーネントを初めて親に追加するときに最後に実行されるコードです。initialize イベントの送出に関する定型作業を行います。コンポーネントを記述しているときは、このメソッドをオーバーライドする必要はありません。

このコンポーネントの内部構造を初期化します。

UIComponent の初期化は、ビジュアルコンポーネントインスタンス作成の 4 番目の手順であり、インスタンスが初めて親に追加されたときに自動的に行われます。したがって、通常は initialize() を呼び出す必要はありません。Flex フレームワークが addChild() および addChildAt() メソッドの UIComponent のオーバーライドからそれを呼び出します。

ビジュアルコンポーネントインスタンス作成の最初の手順は、new 演算子を使用した作成です。

var okButton:Button = new Button();

作成後、新しい Button インスタンスは単独の DisplayObject になります。ラベルを表示する子として UITextField を持っておらず、親もありません。

2 番目の手順では、作成されたインスタンスを適切なプロパティ、スタイル、イベントハンドラで設定します。

okButton.label = "OK";
okButton.setStyle("cornerRadius", 0);
okButton.addEventListener(MouseEvent.CLICK, clickHandler);

3 番目の手順では、インスタンスを親に追加します。

someContainer.addChild(okButton);

コンポーネントを初めて親に追加するときに addChild() または addChildAt() を呼び出すことによる副次的な作用は、initialize が自動的に呼び出されることです。

このメソッドはまず preinitialize イベントを送出し、このコンポーネントを使用する開発者が、内部構造が作成される前にコンポーネントを変更できるようにします。次に、createChildren() メソッドを呼び出してコンポーネントの内部構造を作成します。Button の場合、このメソッドはラベル用の UITextField を作成し、追加します。次に、initialize イベントを送出し、内部構造が作成された後に開発者がコンポーネントを変更できるようにします。

内部構造作成のトリガとなるのは、コンポーネントを初めて親に追加する行為です。内部構造に他の UIComponent が含まれる場合、これは、DisplayObject のツリーが 1 リーフノードずつ増える反復的なプロセスになります。

コンポーネントを記述しているときは、このメソッドをオーバーライドする必要はありません。

このコンポーネントのアクセシビリティコードを初期化します。

このメソッドは、mx.accessibility パッケージの別のクラスに置かれたコンポーネントのアクセシビリティコードをフックするために、initialize() メソッドから呼び出されます。アクセシビリティをサポートする各サブクラスは、このメソッドをオーバーライドする必要があります。フックプロセスでは、各サブクラスで異なる静的変数が使用されるためです。

このコンポーネントの繰り返されるインスタンスを追跡する各種プロパティを初期化します。

MXML <mx:Repeater/> タグにより、コンポーネントのインスタンスが、Repeater のデータプロバイダのアイテムごとに 1 つずつ繰り返し作成される場合があります。UIComponent の instanceIndices、repeaters、および repeaterIndices プロパティは、どのインスタンスがどのデータ項目およびどの Repeater から作成されているのかを追跡します。

このメソッドは、Flex フレームワークによって自動的に呼び出される内部メソッドです。このメソッドを呼び出す必要はなく、オーバーライドする必要もありません。

次に画面が更新されている間に updateDisplayList() メソッドが呼び出されるように、コンポーネントをマークします。

無効化は、後で画面が更新されるまでコンポーネントの変更処理を保留することで、作業の重複を排除できる有用なメカニズムです。たとえば、幅と高さを変更する場合、幅を変更した後にコンポーネントを更新し、次に高さを変更して再度更新するという処理は時間の浪費です。両方のプロパティを変更した後、新しいサイズでコンポーネントを一度に再描画する方が効率的です。

無効化メソッドが呼び出されることはほとんどありません。一般的には、コンポーネントのプロパティを設定すると、自動的に適切な無効化メソッドが呼び出されます。

次に画面が更新されている間に commitProperties() メソッドが呼び出されるように、コンポーネントをマークします。

無効化は、後で画面が更新されるまでコンポーネントの変更処理を保留することで、作業の重複を排除できる有用なメカニズムです。たとえば、テキストのカラーとサイズを変更する場合、カラーを変更した後、すぐにカラーを更新し、次にサイズを設定して、今度はサイズを更新するという処理は時間の浪費です。両方のプロパティを変更した後、新しいサイズとカラーでテキストを一度に再描画する方が効率的です。

無効化メソッドが呼び出されることはほとんどありません。一般的には、コンポーネントのプロパティを設定すると、自動的に適切な無効化メソッドが呼び出されます。

次に画面が更新されている間に measure() メソッドが呼び出されるように、コンポーネントをマークします。

無効化は、後で画面が更新されるまでコンポーネントの変更処理を保留することで、作業の重複を排除できる有用なメカニズムです。たとえば、テキストとフォントサイズを変更する場合、テキストを変更した後、すぐにテキストを更新し、次にサイズを設定して、今度はサイズを更新するという処理は時間の浪費です。両方のプロパティを変更した後、新しいサイズでテキストを一度に再描画する方が効率的です。

無効化メソッドが呼び出されることはほとんどありません。一般的には、コンポーネントのプロパティを設定すると、自動的に適切な無効化メソッドが呼び出されます。

通常、UITextField オブジェクトが含まれているコンポーネントのうち、UITextField オブジェクトがフォーカスを取得したコンポーネントによってオーバーライドされます。

keyDown イベントに対して呼び出されるイベントハンドラです。このメソッドをオーバーライドする場合は、必ず基本クラスのバージョンを呼び出してください。

keyUp イベントに対して呼び出されたイベントハンドラです。このメソッドをオーバーライドする場合は、必ず基本クラスのバージョンを呼び出してください。

Point オブジェクトをローカル座標からコンテンツ座標に変換します。ローカル座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。コンテンツ座標では、コンポーネントのコンテンツの左上隅を基準としたピクセル位置を指定します。現在切り詰められていて、アクセスするにはコンポーネントをスクロールすることが必要な領域も含め、コンポーネントのすべてのコンテンツ領域を含みます。コンテンツ座標系を使用して、絶対配置を使用しているコンテナの子の配置を設定および取得します。

関連項目

コンポーネントのデフォルトサイズを計算するだけでなく、オプションでデフォルトの最小サイズを計算することもできます。これは、UIComponent のサブクラスを作成するときにオーバーライド可能な高度なメソッドです。

このメソッドは直接呼び出さないでください。addChild() メソッドでコンポーネントがコンテナに追加されたとき、およびコンポーネントの invalidateSize() メソッドが呼び出されたときに、Flex により measure() メソッドが呼び出されます。

コンポーネントに特定の高さと幅を設定するとき、invalidateSize() メソッドを明示的に呼び出したとしても、Flex では measure() メソッドを呼び出しません。つまり、Flex はそのコンポーネントの explicitWidth プロパティまたは explicitHeight プロパティが NaN である場合にのみ measure() メソッドを呼び出します。

このメソッドのオーバーライド内で、measuredWidth プロパティおよび measuredHeight プロパティを設定してデフォルトのサイズを定義する必要があります。measuredMinWidth および measuredMinHeight プロパティを設定して、デフォルトの最小サイズをオプションで設定することもできます。

ほとんどのコンポーネントは、表示しているコンテンツと、コンテンツ表示に影響するプロパティに基づいてこれらの値を計算します。一部のコンポーネントでは、ハードコードされたデフォルト値を使用するものもあります。

measure() の概念ポイントは、コンポーネントで独自のナチュラルサイズや組み込みサイズをデフォルトとして指定するためのものです。このため、measuredWidth プロパティおよび measuredHeight プロパティは、以下のような要素に基づいて決定される必要があります。

• コンポーネントでの表示に必要なテキストの量
• fontSize などのテキストのスタイル
• コンポーネントで表示する JPEG イメージのサイズ
• コンポーネントの子の測定サイズまたは明示的なサイズ
• すべての境界線、余白、および間隔

デフォルト値を決める方法がない場合もあります。たとえば、簡単な GreenCircle コンポーネントでは measure() メソッドに measuredWidth = 100 と measuredHeight = 100 のみを設定して、適切なデフォルトサイズを指定することがあります。また、TextArea などの場合には、適切な計算処理 (すべてのテキストを表示し、黄金の矩形の縦横比を得るためだけの正確な幅と高さの検出など) では時間がかかりすぎる場合があります。

measure() のデフォルト実装は、デフォルトのサイズをコンポーネントの現在のサイズに設定するためのものです。

関連項目

この UIComponent のスタイルで決定される UITextFormat を使用して単一行の UITextField に表示するものとして、<font> や <b> のような HTML タグが含まれる指定の HTML テキストを測定します。

この UIComponent のスタイルで決定される UITextFormat を使用して単一行の UITextField に表示するものとして、指定のテキストを測定します。

親の内部の指定された位置にコンポーネントを移動します。このメソッドを呼び出すことは、コンポーネントの x プロパティおよび y プロパティを設定することとまったく同じです。

カスタムコンポーネントの updateDisplayList() メソッドをオーバーライドする場合は、x プロパティおよび y プロパティを設定するのではなく、move() メソッドを呼び出す必要があります。この相違点は、move() メソッドがコンポーネントの場所を変更して、呼び出されたときに move イベントを送出するのに対し、x プロパティおよび y プロパティはコンポーネントの場所を変更して、そのイベントを次回の画面更新時に送出するという点です。

スタイルの変更を子に通知します。通常はこのメソッドを呼び出す必要はありません。

owner プロパティのチェーンが child からこの UIComponent を指定している場合に、true を返します。

UIComponent オブジェクトを親に対して追加または削除したときに Flex によって呼び出されます。開発者は通常このメソッドを呼び出す必要はありません。

印刷用の IFlexDisplayObject を準備します。UIComponent クラスの場合、このメソッドはアクションを実行しません。Flex コンテナはこのメソッドをオーバーライドし、印刷出力からスクロールバーを除去するなど、印刷の準備をします。

アプリケーション開発者は通常このメソッドを使用しません。

関連項目

このコンポーネントの CSS スタイルキャッシュを作成または再作成します。recursive パラメータが true の場合は、このコンポーネントのすべての子孫の CSS スタイルキャッシュも作成または再作成します。

Flex フレームワークは次のような状況でこのメソッドを呼び出します。

• addChild() または addChildAt( メソッドを使用して UIComponent を親に追加するとき。
• UIComponent の styleName プロパティを変更するとき。
• CSSStyleDeclaration の setStyle() メソッドを使用して CSS セレクタでスタイルを設定するとき。

スタイルキャッシュの構築は多くの計算を必要とする操作であるため、styleName の変更やセレクタスタイルの設定を不必要に行わないようにしてください。

このメソッドは、UIComponent の setStyle() メソッドを呼び出してインスタンススタイルを設定する場合には呼び出されません。インスタンススタイルの設定は、セレクタスタイルの設定に比べて比較的高速です。

このメソッドを呼び出す必要はなく、オーバーライドする必要もありません。

各エフェクトイベントについて、EffectManager をイベントリスナーの 1 つとして登録します。通常はこのメソッドを呼び出す必要はありません。

suspendBackgroundProcessing() が呼び出された後、callLater() によってキューに入れられたメソッドのバックグラウンド処理を再開します。

詳細については、suspendBackgroundProcessing() の説明を参照してください。

オブジェクトのサイズを設定します。width プロパティと height プロパティを直接設定する場合とは異なり、setActualSize() メソッドでは、explictWidth プロパティと explicitHeight プロパティは設定されません。このため、レイアウト計算によってオブジェクトが元のサイズに戻る可能性があります。このメソッドは、主に updateDisplayList() を実装するコンポーネントの開発者、Effects、および LayoutManager によって使用されます。

現在の状態を設定します。

関連項目

現在扱っているコンポーネントにフォーカスを設定します。このとき、コンポーネントのサブコンポーネントにフォーカスが渡されることがあります。

メモ: このメソッドがフォーカスを設定したときに、TextInput および TextArea コントロールだけがハイライトを表示します。ユーザーが Tab キーでコントロールを選択すると、すべてのコントロールがハイライトを表示します。

このコンポーネントインスタンスのスタイルプロパティを設定します。

これは、グローバル設定されたスタイルをオーバーライドできます。

setStyle() メソッドを呼び出すと、パフォーマンスが低下することがあります。これは必要な場合のみ使用してください。

関連項目

visible プロパティが変更されたときに呼び出されます。コンポーネントの表示と非表示を切り替えるには、このメソッドを直接呼び出す代わりに visible プロパティを設定してください。

スタイルプロパティの変更を検出します。何らかのスタイルプロパティが設定されていると、Flex が styleChanged() メソッドを呼び出し、設定されているスタイルの名前を渡します。

これは、UIComponent のサブクラスを作成するときにオーバーライド可能な高度なメソッドです。カスタムコンポーネントを作成するときには、渡されたスタイル名をチェックし、その結果に従って変更内容を処理するよう、styleChanged() メソッドをオーバーライドできます。これにより、既存スタイルのデフォルト動作をオーバーライドできるだけでなく、独自のスタイルプロパティを追加することもできます。

スタイルプロパティを処理する場合には、次回の画面更新時に Flex がコンポーネントの updateDisplayList() メソッドを実行するよう、styleChanged() メソッドのオーバーライドで invalidateDisplayList() メソッドを呼び出す必要があります。

コンポーネントのスタイルを初めて初期化するとき、Flex は stylesInitialized() メソッドを呼び出します。

これは、UIComponent のサブクラスを作成するときにオーバーライド可能な高度なメソッドです。Flex は、コンポーネントの measure および updateDisplayList メソッドが初めて呼び出されるまでに、コンポーネントのスタイルが完全に初期化されることを保証します。ほとんどのコンポーネントでは、それで十分です。ただし、早い段階でスタイル値にアクセスする必要がある場合は、stylesInitialized() 関数をオーバーライドして、スタイルプロパティが初めて初期化されたときに直ちにアクセス可能にすることができます。

resumeBackgroundProcessing() が呼び出されるまで、callLater() によってキューに入れられたメソッドのバックグラウンド処理をブロックします。

これらのメソッドは、中断なしに実行する必要のあるタイムクリティカルなコードを使用しているときに有効です。たとえば、エフェクトの suspendBackgroundProcessing プロパティを trueに設定すると、アニメーションを滑らかにするために、再生の開始時に suspendBackgroundProcessing() が自動的に呼び出され、停止時に resumeBackgroundProcessing が呼び出されます。

LayoutManager は callLater() を使用するため、commitProperties()、measure()、および updateDisplayList() は、suspendBackgroundProcessing() と resumeBackgroundProcessing() の呼び出しの間は呼び出されないことになります。

外側のメソッドと内側のメソッド (外側のメソッドによって呼び出されるメソッド) の両方が suspendBackgroundProcessing() と resumeBackgroundProcessing() を呼び出すようにするほうが安全です。これらのメソッドは、バックグラウンド処理の実行を決めるカウンタを加算および減算するためです。

オブジェクトの描画およびその子のサイズや位置の設定を行います。これは、UIComponent のサブクラスを作成するときにオーバーライド可能な高度なメソッドです。

このメソッドは直接呼び出さないでください。addChild() メソッドでコンポーネントがコンテナに追加されたとき、およびコンポーネントの invalidateDisplayList() メソッドが呼び出されたときに、Flex が updateDisplayList() メソッドを呼び出します。

コンポーネントに子がない場合は、このメソッドで graphics.drawRect() などコンポーネントの Graphics オブジェクトに対するメソッドをいくつか使用して、プログラムによる描画を実行することになります。

コンポーネントに子がある場合は、このメソッドでその子に対して move() メソッドおよび setActualSize() メソッドを呼び出すことになります。

コンポーネントの中には、子がある場合でもプログラムによる描画を実行できるものがあります。いずれの場合でも、描画するときは、コンポーネントの unscaledWidth および unscaledHeight を境界として使用する必要があります。

width プロパティおよび height プロパティではなく、unscaledWidth および unscaledHeight を使用することが重要です。

関連項目

子の位置とサイズを検証し、その他のビジュアルオブジェクトを描画します。この ILayoutManagerClient クライアントの場合に LayoutManager.invalidateDisplayList() メソッドを呼び出すと、表示リストを更新する時点で validateDisplayList() メソッドが呼び出されます。

必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。相当量の計算を必要とするプロパティの処理は、通常はスクリプトの実行が終了するまで実行されません。たとえば、width プロパティの設定は遅らされます。これは、オブジェクトの子または親の幅の再計算が必要になる可能性があるためです。処理を遅らせることにより、スクリプトで width プロパティが複数回設定されても、処理を何度も繰り返さずにすみます。このメソッドでは、この動作を手動でオーバーライドできます。

commitProperties() メソッドを呼び出してコンポーネントのプロパティを検証するためにレイアウトロジックによって使用されます。一般にサブクラスは、このメソッドではなく commitProperties() メソッドをオーバーライドすべきです。

コンポーネントの測定サイズを検証します。LayoutManager.invalidateSize() メソッドがこの ILayoutManagerClient を指定して呼び出された場合、測定の実行時に validateSize() メソッドが呼び出されます。

このコンポーネントに割り当てられたバリデータからの valid と invalid の両方のイベントを処理します。

通常、バリデータにイベントリスナーを割り当てることで、バリデータによって送出された valid イベントおよび invalid イベントを処理します。検証中のコンポーネントで直接検証イベントを処理する場合は、このメソッドをオーバーライドすると valid イベントおよび invalid イベントを処理できます。通常はオーバーライド時に super.validationResultHandler(event) を呼び出します。

関連項目

垂直方向のグラデーションを描画するときに rot パラメータとして drawRoundRect() メソッドに渡すことのできるボックスの Matrix を返します。

パフォーマンスのために、Matrix は静的変数に保存され、horizontalGradientMatrix() および verticalGradientMatrix() に対するすべての呼び出しで再使用されます。したがって、horizontalGradientMatrix() または verticalGradientMatrix() を再度呼び出す前に、この Matrix を drawRoundRect() に渡す必要があります。

addChild() メソッドまたは addChildAt() メソッドを使用してコンポーネントをコンテンツの子としてコンテナに追加したときに送出されます。rawChildren.addChild() または rawChildren.addChildAt() メソッドを使用してコンポーネントをコンテンツではない子としてコンテナに追加した場合、イベントは送出されません。

FlexEvent.ADD 定数により、add イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

コンポーネントの構築、プロパティ処理、測定、レイアウト、および描画が完了したときに送出されます。

この時点では、visible プロパティによってはコンポーネントが描画されても表示されない場合があります。

FlexEvent.CREATION_COMPLETE 定数により、creationComplete イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

ビューステートの変更後に送出されます。

StateChangeEvent.CURRENT_STATE_CHANGE 定数により、ビューステートが変更されたときに送出されるイベントの type プロパティ値が定義されます。この定数の値は "currentStateChange" です。

イベントオブジェクトの各プロパティには次の値が設定されます。

currentState プロパティが変更された後に送出されます。ビューステートが変更される前には送出されません。

StateChangeEvent.CURRENT_STATE_CHANGING 定数により、ビューステートが変更されようとしているときに送出されるイベントの type プロパティ値が定義されます。この定数の値は "currentStateChanging" です。

イベントオブジェクトの各プロパティには次の値が設定されます。

ドラッグ操作が完了したとき (ドラッグデータをドロップターゲットにドロップするか、ドロップを実行せずにドラッグ & ドロップ操作を終了したときのいずれか)、ドラッグイニシエータ (ドラッグしたデータのソースであるコンポーネント) によって送出されます。

このイベントは、ドラッグ & ドロップ操作の最終的なクリーンアップを行うために使用できます。たとえば、List コントロールアイテムをあるリストから別のリストにドラッグする場合、List コントロールアイテムがそれ以降必要でなければソースから削除することができます。

DragEvent.DRAG_COMPLETE 定数により、dragComplete イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

ユーザーがドロップターゲット上でマウスを離したとき、ドロップターゲットによって送出されます。

このイベントハンドラは、ドラッグデータをドロップターゲットに追加するために使用します。

DragEvent.DRAG_DROP 定数により、dragDrop イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

ドラッグ操作時に、コンポーネント上でマウスを移動したとき、コンポーネントによって送出されます。

コンポーネントを有効なドロップターゲットとするには、このイベントのハンドラを定義する必要があります。ハンドラ内では、コンポーネントがドラッグを受け付けることができることを示す視覚的なフィードバックをユーザーに提供するために、ドロップターゲットの外観を変更できます。たとえば、ドロップターゲットの周囲に境界線を表示したり、ドロップターゲットにフォーカスを移すことができます。

ドラッグを受け入れる場合は、DragManager.acceptDragDrop() メソッドを呼び出す必要があります。acceptDragDrop() を呼び出さないと、他のドラッグイベントがすべて取得されなくなります。

action プロパティの値は、コピーの実行中も常に DragManager.MOVE です。これは、Control キーが押され、コピーが通知されたことをコントロールが認識する前に dragEnter イベントが発生するためです。dragOver イベントのイベントオブジェクトの action プロパティには、ドラッグ操作の種類を示した値が含まれています。

DragManager.showFeedback() メソッドを呼び出してドラッグアクションの種類を変更することもできます。

DragEvent.DRAG_ENTER 定数により、dragEnter イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

関連項目

ユーザーがデータをコンポーネントの外部にドラッグし、ターゲットにドロップしなかったとき、コンポーネントによって送出されます。

このイベントは、dragEnter または dragOver イベントの処理中にドロップターゲットの外観を変更した場合に、ドロップターゲットを通常の外観に復元するのに使用します。

DragEvent.DRAG_EXIT 定数により、dragExit イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

ドラッグ操作時に、コンポーネント上でマウスを移動したとき、コンポーネントによって送出されます。

ハンドラ内では、コンポーネントがドラッグを受け付けることができることを示す視覚的なフィードバックをユーザーに提供するために、ドロップターゲットの外観を変更できます。たとえば、ドロップターゲットの周囲に境界線を表示したり、ドロップターゲットにフォーカスを移すことができます。

このイベントは、ドロップを許可する前に追加のロジックを実行するために使用します。追加のロジックの例としては、ドロップターゲット内のいろいろな場所にデータをドロップする操作、キーボード入力を読み取って、ドラッグ & ドロップアクションがドラッグデータの移動またはコピーのどちらであるかを判別する操作、ドラッグ & ドロップアクションのタイプに基づいて異なるタイプの視覚的なフィードバックを提供する操作などがあります。

DragManager.showFeedback() メソッドを変更してドラッグアクションの種類を変更することもできます。action プロパティのデフォルト値は DragManager.MOVE です。

DragEvent.DRAG_OVER 定数により、dragOver イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

関連項目

エフェクトの終了後に送出されます。

このイベントが発行される前に、エフェクトによって視覚的な変更の最後のセットが実行されていますが、これらの変更は画面に描画されていません。したがって、これらの変更が画面に描画されるまで、callLater() メソッドを使用して他の変更を延期することが必要になる場合があります。

EffectEvent.EFFECT_END 定数により、effectEnd イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

エフェクトが開始される直前に送出されます。

このイベントが発行されるまで、エフェクトによる視覚的な変更は開始されません。

EffectEvent.EFFECT_START 定数により、effectStart イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

コンポーネントがルートビューステートに戻った後に送出されます。

FlexEvent.ENTER_STATE 定数により、enterState イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

コンポーネントがルートビューステートを終了する前に送出されます。

FlexEvent.EXIT_STATE 定数により、exitState イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

オブジェクトの状態が可視から不可視に変化したときに送出されます。

FlexEvent.HIDE 定数により、hide イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

コンポーネントの構築と初期化プロパティの設定が完了したときに送出されます。

初期化段階の後、プロパティの処理、コンポーネントの測定、レイアウト、描画が実行され、creationComplete イベントが送出されます。

FlexEvent.INITIALIZE 定数により、initialize イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

バリデータによってコンポーネントが監視されており、検証が失敗した場合に送出されます。

FlexEvent.INVALID 定数により、invalid イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

ユーザーが PopUpManager を使用して開いたコンポーネントの外側でマウスをクリックしたときに、そのコンポーネントから送出されます。

FlexMouseEvent.MOUSE_DOWN_OUTSIDE 定数により、mouseDownOutside イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

ユーザーが PopUpManager を使用して開いたコンポーネントの外側にマウスホイールをスクロールしたときに、そのコンポーネントから送出されます。

FlexMouseEvent.MOUSE_WHEEL_OUTSIDE 定数により、mouseWheelOutside イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

オブジェクトが移動したときに送出されます。

コンポーネントを移動するには、x または y プロパティを設定するか、move() メソッドを呼び出します。あるいは、そのコンポーネントまたはその他のコンポーネントについて、LayoutManager がそのコンポーネントの x または y プロパティを変更することが必要になるように、次のプロパティの 1 つを設定します。

• minWidth
• minHeight
• maxWidth
• maxHeight
• explicitWidth
• explicitHeight

move() メソッドを呼び出すと、メソッドが返る前に move イベントが送出されます。その他の状況では、move イベントは、プロパティが変更されるまで送出されません。

MoveEvent.MOVE 定数により、move イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

コンポーネントの初期化シーケンスの始めに送出されます。このイベントが送出されるときのコンポーネントの状態は未処理です。Button コントロールをはじめ、多くのコンポーネントは、内部子コンポーネントを作成して機能を実装します。たとえば、Button コントロールは、ラベルテキストを表す内部 UITextField コンポーネントを作成します。Flex が preinitialize イベントを送出したとき、コンポーネントの子は、内部の子も含めて、まだ作成されていません。

FlexEvent.PREINITIALIZE 定数により、preinitialize イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

removeChild() または removeChildAt() メソッドを使用してコンポーネントをコンテンツの子としてコンテナから削除したときに送出されます。rawChildren.removeChild() または rawChildren.removeChildAt() メソッドを使用してコンポーネントをコンテンツではない子としてコンテナから削除した場合、イベントは送出されません。

FlexEvent.REMOVE 定数により、remove イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

コンポーネントのサイズが変更されたときに送出されます。

コンポーネントのサイズを変更するには、width または height プロパティを設定するか、setActualSize() メソッドを呼び出します。あるいは、そのコンポーネントまたはその他のコンポーネントについて、LayoutManager がそのコンポーネントの width または height プロパティを変更することが必要になるように、次のプロパティの 1 つを設定します。

• minWidth
• minHeight
• maxWidth
• maxHeight
• explicitWidth
• explicitHeight

resize イベントは、プロパティが変更されるまで送出されません。

ResizeEvent.RESIZE 定数により、resize イベントのイベントオブジェクトの type プロパティ値が定義されます。

イベントオブジェクトの各プロパティには次の値が設定されます。