UITextField  - AS3 Flex

オートメーション関連機能を処理する委譲オブジェクトです。

このコンポーネントがオートメーション用に有効である場合は true、それ以外の場合は false です。

このオブジェクトの識別子として使用できる名前です。

オートメーション目的で使用するこのコンポーネントのオーナーです。

オートメーション目的で使用するこのコンポーネントの親です。

この値はオブジェクトのレンダリング表示に対応しています。また、アプリケーションでの視覚表示と同じにするために、識別子とオブジェクトを関連付けるのに使用できます。

このコンポーネントがオートメーション用に可視である場合は true、それ以外の場合は false です。

テキストの 1 行目のベースラインの y 座標です。

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

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

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

コンポーネントが有効になっているかどうかを示すブール値です。 このプロパティはテキストの色のみに影響し、UITextField が編集可能かどうかには影響しません。 編集可能かどうかを制御するには、flash.text.TextField.type プロパティを使用します。

デフォルト値： true。

関連する API エレメント

コンポーネントがフォーカスを得たときに、IME を有効にするかどうかを指定するフラグです。

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

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

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

maxHeight プロパティが設定されている場合に、コンポーネントの座標内におけるコンポーネントの最大の高さ (ピクセル単位) を指定する数値です。maxHeight は読み取り専用であるため、このメソッドは NaN を返します。このプロパティを使用するには、このメソッドをオーバーライドし、setter を追加する必要があります。

デフォルト値： NaN。

関連する API エレメント

maxWidth プロパティが設定されている場合に、コンポーネントの座標内におけるコンポーネントの最大の幅 (ピクセル単位) を指定する数値です。maxWidth は読み取り専用であるため、このメソッドは NaN を返します。このプロパティを使用するには、このメソッドをオーバーライドし、setter を追加する必要があります。

デフォルト値： NaN。

関連する API エレメント

レイアウト中に親によって考慮されるコンポーネントの最小推奨高さです。この値は、ピクセル単位でのコンポーネント座標内にあります。

アプリケーション開発者は、通常は explicitMinHeight プロパティを設定しません。代わりに、explicitMinHeight プロパティを設定する minHeight プロパティの値を設定します。minHeight の値は変化しません。

レイアウト時に、minHeight がアプリケーション開発者によって明示的に設定された場合は、explicitMinHeight の値が使用されます。それ以外の場合は、measuredMinHeight の値が使用されます。

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

レイアウト中に親によって考慮されるコンポーネントの最小推奨幅です。この値は、ピクセル単位でのコンポーネント座標内にあります。

アプリケーション開発者は、通常は explicitMinWidth プロパティを設定しません。代わりに、explicitMinWidth プロパティを設定する minWidth プロパティの値を設定します。minWidth の値は変化しません。

レイアウト時に、minWidth がアプリケーション開発者によって明示的に設定された場合は、explicitMinWidth の値が使用されます。それ以外の場合は、measuredMinWidth の値が使用されます。

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

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

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

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

複数のコンポーネント間で共有され、フォーカスインジケーター描画のオーバーレイとして使用される単一の Sprite オブジェクトです。コンポーネントは、親がフォーカスの設定されたコンポーネントの場合にこのオブジェクトを共有します。コンポーネントが IFocusManagerComponent インターフェイスを実装している場合には共有しません。

true の場合、paddingLeft および paddingRight スタイルはコンポーネントのテキストの周囲にスペースを追加しません。

デフォルト値： true。

IME（入力メソッドエディター）のモードを指定します。IME を使用することによって、ユーザーは中国語、日本語、および韓国語のテキストを入力できます。Flex では、コントロールにフォーカスが置かれたときに、IME を指定されたモードに設定し、コントロールからフォーカスが離れたときに、元のモードに戻します。

このプロパティで有効な値の定数は、flash.system.IMEConversionMode クラスで定義されています。IME を指定しない場合は、null を指定します。

デフォルト値： null。

関連する API エレメント

このコンポーネントを親コンテナのレイアウトに含めるかどうかを指定します。 true の場合、オブジェクトは、親コンテナのレイアウトに含められます。オブジェクトのサイズと位置は、親コンテナによって、そのレイアウト規則に従って決定されます。false の場合、オブジェクトのサイズと位置は、親コンテナのレイアウトの影響を受けません。

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

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

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

レイアウト中に親によって考慮されるコンポーネントの最大推奨高さです。この値は、ピクセル単位でのコンポーネント座標内にあります。このプロパティのデフォルト値は、コンポーネント開発者によって設定されます。

コンポーネント開発者は、このプロパティを使用して、コンポーネントの高さの上限を設定します。

アプリケーション開発者が maxHeight のデフォルト値をオーバーライドした場合は、新しい値が explicitMaxHeight に格納されます。maxHeight のデフォルト値は変化しません。その結果、レイアウト時に、アプリケーション開発者によって maxHeight が明示的に設定された場合は、explicitMaxHeight の値がコンポーネントの最大推奨高さに使用されます。maxHeight がユーザーによって明示的に設定されない場合は、デフォルト値が使用されます。

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

レイアウト中に親によって考慮されるコンポーネントの最大推奨幅です。この値は、ピクセル単位でのコンポーネント座標内にあります。このプロパティのデフォルト値は、コンポーネント開発者によって設定されます。

コンポーネント開発者は、このプロパティを使用して、コンポーネントの幅の上限を設定します。

アプリケーション開発者が maxWidth のデフォルト値をオーバーライドした場合は、新しい値が explicitMaxWidth に格納されます。maxWidth のデフォルト値は変化しません。その結果、レイアウト時にアプリケーション開発者によって maxWidth が明示的に設定された場合は、explicitMaxWidth の値がコンポーネントの最大推奨幅に使用されます。maxWidth がユーザーによって明示的に設定されない場合は、デフォルト値が使用されます。

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

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

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

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

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

レイアウト中に親によって考慮されるコンポーネントの最小推奨高さです。この値は、ピクセル単位でのコンポーネント座標内にあります。デフォルト値は、コンポーネントの実装に依存します。

アプリケーション開発者が minHeight の値を設定した場合は、新しい値が explicitMinHeight に格納されます。minHeight のデフォルト値は変化しません。その結果、レイアウト時に、アプリケーション開発者によって minHeight が明示的に設定された場合は、explicitMinHeight の値がコンポーネントの最小推奨高さに使用されます。minHeight がアプリケーション開発者によって明示的に設定されていない場合は、measuredMinHeight の値が使用されます。

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

レイアウト中に親によって考慮されるコンポーネントの最小推奨幅です。この値は、ピクセル単位でのコンポーネント座標内にあります。デフォルト値は、コンポーネントの実装に依存します。

アプリケーション開発者が minWidth の値を設定した場合は、新しい値が explicitMinWidth に格納されます。minWidth のデフォルト値は変化しません。その結果、レイアウト時にアプリケーション開発者によって minWidth が明示的に設定された場合は、explicitMinWidth の値がコンポーネントの最小推奨幅に使用されます。minWidth がアプリケーション開発者によって明示的に設定されていない場合は、measuredMinWidth の値が使用されます。

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

TextField を正しい SWF コンテキストで作成するために使用する moduleFactory です。これは、埋め込みフォントを機能させるために必要です。

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

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

textHeight と異なり、これはテキストが空の場合でもゼロ以外の値を返します。この場合、テキストが空でなかったときの textHeight の値を返します。

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

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

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

このコンポーネントの親コンテナまたは親コンポーネントです。

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

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

UITextField コントロールの場合、このプロパティは常に NaN に設定されます。

Spark レイアウトで使用した場合、このプロパティは、拡大 / 縮小後および回転後のコンポーネントの境界の高さの計算に使用されます。例えば、コンポーネントを 90°回転する場合、指定されている percentHeight はコンポーネントの幅に影響を与えます。

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

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

UITextField コントロールの場合、このプロパティは常に NaN に設定されます。

Spark レイアウトで使用した場合、このプロパティは、拡大 / 縮小後および回転後のコンポーネントの境界の幅の計算に使用されます。例えば、コンポーネントを 90°回転する場合、指定されている percentWidth はコンポーネントの高さに影響を与えます。

createChildren() メソッドによって内部的なコンポーネントの子が作成された後、true に設定されます。

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

ストリングの場合、この値は <fx:Style> タグまたは CSS ファイル内にある空白区切りのクラス宣言の名前です。styleName にはピリオドを含めません。 例えば、".bigText" という名前のクラススタイルの場合は、styleName プロパティを "bigText"（ピリオドなし）に設定します。

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

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

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

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

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

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

コンストラクターです。

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

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

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

このメソッドは、あらゆる種類のスタイルプロパティの取得に使用されるため、戻り値は Boolean、String、Number、int、uint（RGB カラーの場合）、Class（スキンの場合）、または何らかのオブジェクトになります。したがって、戻り値の型は単に * として指定されます。

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

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

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

パラメーター

この UITextField オブジェクトの文字フォーマット情報を表す TextFormat オブジェクトを返します。

関連する API エレメント

このコンポーネントのフォーマット情報を含む UITextFormat オブジェクトを返します。このメソッドは、flash.text.TextField クラスの getTextFormat() メソッドに似ていますが、TextFormat オブジェクトではなく UITextFormat オブジェクトを返します。

UITextFormat クラスは TextFormat クラスを拡張し、テキスト測定メソッドの measureText() および measureHTMLText() を追加します。

関連する API エレメント

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

これは IUIComponent インターフェイスが必要とするメソッドですが、UITextField に対しては実際には何もしません。

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

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

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

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

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

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

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

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

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

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

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

パラメーター

子の親がこのオブジェクトである場合、または子がこのオブジェクトに所有されている場合に、true を返します。

パラメーター

関連する API エレメント

この関数は、UITextField オブジェクトに親が割り当てられたときに呼び出されます。通常はこのメソッドを呼び出す必要はありません。

パラメーター

指定されたイベントを再生します。 デフォルトの再生動作がスーパークラスで定義されている場合、コンポーネント作成者は super.replayAutomatableEvent を呼び出すはずです。

パラメーター

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

パラメーター

テキストのフォントの色を設定します。

パラメーター

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

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

何もしません。UITextField にはインラインスタイルは定義できません。

パラメーター

この UITextField オブジェクトの visible プロパティを設定します。

パラメーター

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

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

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

パラメーター

コントロールに定義された領域に水平方向に収まるようテキストを切り詰めて、省略記号つまり 3 つのピリオド（...）をテキストに付加します。

パラメーター

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