IUITextField  - AS3 Flex

true に設定され、テキストフィールドにフォーカスがない場合、テキストフィールド内の選択内容は灰色でハイライト表示されます。false に設定され、テキストフィールドにフォーカスがない場合、テキストフィールド内の選択内容はハイライト表示されません。

このテキストフィールドに使用されるアンチエイリアス処理のタイプです。このプロパティには、flash.text.AntiAliasType 定数を使用します。この設定は、フォントが埋め込まれている（embedFonts プロパティが true に設定されている）場合にのみ制御できます。デフォルト設定は、flash.text.AntiAliasType.NORMAL です。

このプロパティの値を設定するには、次のストリング値を使用します。

テキストフィールドの自動的な拡大 / 縮小および整列を制御します。TextFieldAutoSize 定数の有効な値は次のとおりです。TextFieldAutoSize.NONE（デフォルト）、TextFieldAutoSize.LEFT、TextFieldAutoSize.RIGHT、および TextFieldAutoSize.CENTER。

autoSize が TextFieldAutoSize.NONE（デフォルト値）に設定されていると、サイズ変更は行われません。

autoSize を TextFieldAutoSize.LEFT に設定すると、テキストは左揃えテキストとして扱われます。つまり、テキストフィールドの左インデントが固定され、テキストフィールドの単一行の右インデントのみが伸縮します。テキストに改行（"\n" または "\r" など）が含まれる場合、テキストの次の行が収まるようにフィールドの下側も拡張されます。wordWrap も true に設定した場合、テキストフィールドの下側だけが伸縮し、右側は固定されたままになります。

autoSize を TextFieldAutoSize.RIGHT に設定すると、テキストは右揃えテキストとして扱われます。つまり、テキストフィールドの右インデントが固定され、テキストフィールドの単一行の左インデントのみが伸縮します。テキストに改行（"\n" または "\r" など）が含まれる場合、テキストの次の行が収まるようにフィールドの下側も拡張されます。wordWrap も true に設定した場合、テキストフィールドの下側だけが伸縮し、左側は固定されたままになります。

autoSize を TextFieldAutoSize.CENTER に設定すると、テキストは中央揃えテキストとして扱われます。つまり、テキストフィールドの単一行のサイズ変更を行うと、左右両インデントが均等に伸縮されます。テキストに改行（"\n" または "\r" など）が含まれる場合、テキストの次の行が収まるようにフィールドの下側も拡張されます。wordWrap も true に設定した場合、テキストフィールドの下側だけが伸縮し、左右両側は固定されたままになります。

テキストフィールドに背景の塗りつぶしがあるかどうかを指定します。true である場合、テキストフィールドに背景の塗りがあります。false である場合、テキストフィールドには背景の塗りがありません。backgroundColor プロパティを使用して、テキストフィールドの背景色を設定します。

テキストフィールドの背景の色です。デフォルト値は 0xFFFFFF（白）です。このプロパティは、現在背景がない場合でも取得または設定できます。ただし、背景の色が表示されるのはテキストフィールドの background プロパティが true に設定されている場合のみです。

テキストフィールドに境界線があるかどうかを指定します。true である場合、テキストフィールドに境界線があります。false である場合、テキストフィールドに境界線がありません。borderColor プロパティを使用して、境界線の色を設定します。

テキストフィールドの境界線の色です。デフォルト値は 0x000000（黒）です。このプロパティは、現在境界線がない場合でも取得または設定できます。ただし、境界線の色が表示されるのはテキストフィールドの border プロパティが true に設定されている場合のみです。

指定されたテキストフィールドに現在表示されている一番下の行を示す整数です（1 から始まるインデックス）。テキストフィールドは、テキストのブロックにかぶせたウィンドウのようなものです。scrollV プロパティは、そのウィンドウに表示されている先頭行を示すインデックスです（1 から始まるインデックス）。

scrollV と bottomScrollV で示される行の間のすべてのテキストが、テキストフィールドに現在表示されています。

カーソル（キャレット）位置のインデックスです。カーソルが表示されていない場合、この値は、フォーカスをフィールドに戻した場合にカーソルが表示される位置を示します。通常は、カーソルの最後の位置を示します。フィールドにフォーカスがなかった場合は 0 になります。

選択範囲のインデックスは 0 から始まります。つまり、最初の位置は 0、2 番目の位置は 1 で、以下同様に続きます。

HTML テキストが含まれるテキストフィールド内の余分な空白（スペース、改行など）を削除するかどうかを指定するブール値です。デフォルト値は false です。condenseWhite プロパティは、htmlText プロパティで設定されたテキストにのみ影響し、text プロパティで設定されたテキストには影響しません。text プロパティでテキストを設定した場合、condenseWhite は無視されます。

condenseWhite を true に設定した場合は、テキストフィールド内で改行を指定するときに <BR> や <P> といった標準の HTML コマンドを使用します。

condenseWhite プロパティは htmlText プロパティを設定する前に設定します。

新しく挿入するテキスト（ユーザーが入力したテキストや replaceSelectedText() メソッドで挿入したテキストなど）に適用するフォーマットを指定します。

注意：setSelection() と replaceSelectedText() で置き換える文字を選択する場合は、末尾文字も含めてテキスト全体を選択した場合に限り、defaultTextFormat が適用されます。次に例を示します。

     var my_txt:TextField new TextField();
     my_txt.text = "Flash Macintosh version";
     var my_fmt:TextFormat = new TextFormat();
     my_fmt.color = 0xFF0000;
     my_txt.defaultTextFormat = my_fmt;
     my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied
     my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied
     my_txt.replaceSelectedText("Windows version");
     

defaultTextFormat プロパティにアクセスすると、すべてのプロパティが定義された TextFormat オブジェクトが返されます。null のプロパティはありません。

注意： このプロパティはテキストフィールドにスタイルシートが適用されていると設定できません。

テキストフィールドがパスワードテキストフィールドであるかどうかを指定します。このプロパティの値が true である場合、テキストフィールドはパスワードテキストフィールドとして扱われ、入力された文字は実際の文字の代わりにアスタリスクで隠されます。false である場合、テキストフィールドはパスワードテキストフィールドとして扱われません。パスワードモードを有効にすると、「カット」コマンドと「コピー」コマンド、およびそれに対応するキーボードショートカットが機能しなくなります。このセキュリティ機能により、ユーザーの不在時にキーボードショートカットを使用して悪質なユーザーがパスワードを盗むことを防止できます。

オブジェクトが doubleClick イベントを受け取るかどうかを指定します。デフォルト値は false です。これは、InteractiveObject インスタンスがデフォルトでは doubleClick イベントを受け取らないことを意味します。doubleClickEnabled プロパティがtrue に設定される場合、インスタンスはその境界内で doubleClick イベントを受け取ります。InteractiveObject インスタンスの mouseEnabled プロパティもtrue に設定する必要があります。この設定は、オブジェクトが doubleClick イベントを受け取るようにするには必須です。

このプロパティを設定しても、イベントは送出されません。addEventListener() メソッドの使用は、doubleClick イベントのイベントリスナーを追加する場合に必須です。

埋め込みフォントのアウトラインを使用してレンダリングするかどうかを指定します。false である場合は、デバイスフォントを使用してテキストフィールドをレンダリングします。

テキストフィールドの embedFonts プロパティを true に設定する場合、テキストフィールドに適用される TextFormat オブジェクトの font プロパティを使用して、そのテキストのフォントを指定する必要があります。指定したフォントが SWF ファイルに埋め込まれていない場合、テキストは表示されません。

このオブジェクトがフォーカス矩形を表示するかどうかを指定します。true、false または null の 3 つの値のいずれかを指定できます。true および false の値は、予想されるとおり、フォーカス矩形を表示するかどうかが指定されます。null 値は、このオブジェクトが Stage の stageFocusRect プロパティに従うことを示します。

このテキストフィールドに使用されるグリッドフィッティングのタイプです。このプロパティは、テキストフィールドの flash.text.AntiAliasType プロパティが flash.text.AntiAliasType.ADVANCED に設定されている場合にのみ適用されます。

使用されるグリッドフィッティングのタイプによって、太い水平線と垂直線がピクセルグリッドまたはサブピクセルグリッドに合わされるか、まったく合わされないかが決定されます。

flash.text.GridFitType プロパティでは、次のストリング値を使用できます。

テキストフィールドの内容を HTML で表します。

Flash Player では、次の HTML タグがサポートされています。

Flash Player および AIR では、次の HTML エンティティがサポートされています。

Flash Player および AIR ではまた、&（ASCII のアンパサンド）や €（Unicode の € シンボル）など、文字コードの明示的な指定もサポートされています。

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

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

テキストフィールド内の文字数です。タブ（\t）などの文字も 1 文字としてカウントされます。

ユーザーが入力するときに、テキストフィールドに入力できる最大の文字数です。スクリプトは maxChars の許容数を超えるテキストを挿入できます。maxChars プロパティで指定されるのは、ユーザーが入力できるテキストの量だけです。このプロパティの値が 0 である場合、ユーザーが入力できるテキストの量には制限がありません。

scrollH の最大値です。

scrollV の最大値です。

このオブジェクトでマウスまたはその他のユーザー入力メッセージを受け取るかどうかを指定します。デフォルト値は true であり、これは表示リスト上の InteractiveObject インスタンスがデフォルトでマウスイベントまたはその他のユーザー入力イベントを受け取ることを意味します。mouseEnabled を false に設定すると、インスタンスでは、マウスイベント（またはキーボードイベントなど、その他のユーザー入力イベント）を一切受け取りません。表示リスト上のこのインスタンスの子は影響を受けません。表示リスト上のオブジェクトのすべての子に関する mouseEnabled 動作を変更するには、flash.display.DisplayObjectContainer.mouseChildren を使用します。

このプロパティを設定しても、イベントは送出されません。インタラクティブな機能を作成するには、addEventListener() メソッドを使用する必要があります。

複数行にわたるテキストフィールドで、ユーザーがテキストフィールドをクリックしてホイールを回転させると、自動的にスクロールするかどうかを示すブール値です。デフォルト値は true です。このプロパティは、マウスホイールでテキストフィールドをスクロールしない場合や、テキストフィールドのスクロールを独自に実装する場合に便利です。

フィールドが複数行テキストフィールドであるかどうかを示します。値が true である場合は複数行テキストフィールド、値が false である場合は単一行テキストフィールドです。TextFieldType.INPUT タイプのフィールドでは、multiline の値によって、Enter キーで改行されるかどうかが決定されます（値が false の場合 Enter キーは無視されます）。TextField の multiline の値が false に設定されている場合、テキストをこのフィールドに貼り付けると、改行は削除されます。

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

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

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

複数行テキストフィールド内のテキスト行の数を定義します。wordWrap プロパティが true に設定されている場合、テキストが折り返されると行数は増えます。

ユーザーがテキストフィールドに入力できる文字のセットを指定します。restrict プロパティの値が null である場合は、任意の文字を入力できます。restrict プロパティの値が空のストリングである場合は、いずれの文字も入力できません。restrict プロパティの値が文字のストリングである場合は、そのストリング内の文字のみをテキストフィールドに入力できます。ストリングは左から右へスキャンされます。ハイフン（-）文字を使用して、範囲を指定できます。制限されるのはユーザー入力のみです。スクリプトは任意のテキストをテキストフィールドに入力できます。このプロパティは、プロパティインスペクターの埋め込みフォントのオプションと同期しません。

ストリングがキャレット（^）文字で始まる場合、そのストリングに含まれる文字を除いて、すべての文字を入力できます。ストリングがキャレット（^）文字以外で始まる場合は、そのストリングに含まれる文字のみを入力できます。

次の例では、大文字、スペース、および数値のみをテキストフィールドに入力できます。

     my_txt.restrict = "A-Z 0-9";
     

次の例では、小文字を除くすべての文字を入力できます。

     my_txt.restrict = "^a-z";
     

円記号を使用して ^ または - のリテラルを入力できます。許容される円記号のシーケンスは \-、\^、または \\ です。円記号をストリングの 1 文字として実際に使用するには、ActionScript で指定するときに円記号を 2 つ続けて指定する必要があります。例えば、次のコードで表されているのはダッシュ（-）とキャレット（^）のみです。

     my_txt.restrict = "\\-\\^";
     

ストリング内では任意の場所で ^ を使用し、入力できる文字と除外する文字を切り替えることができます。次のコードでは、大文字のみを入力できます。ただし、大文字の Q を除きます。

     my_txt.restrict = "A-Z^Q";
     

¥u エスケープシーケンスを使用して restrict ストリングを作成できます。次のコードでは、ASCII 32（スペース）から ASCII 126（チルダ）までの文字のみを入力できます。

     my_txt.restrict = "\u0020-\u007E";
     

現在の水平スクロール位置です。scrollH プロパティが 0 である場合、テキストは水平にスクロールされません。このプロパティの値は、水平位置をピクセル単位で表す整数です。

垂直スクロールの単位は行数ですが、水平スクロールの単位はピクセル数です。水平スクロールをピクセル単位で指定するのは、一般的に使用されるフォントのほとんどがプロポーショナルフォントであり、文字の幅が一定でないためです。垂直スクロールの場合は、通常、1 行のテキストの一部だけ表示されるよりも行全体が表示されることが好まれるため、行単位でスクロールします。1 行の中に複数のフォントが存在する場合でも、使用されている最大のフォントに合わせて行の高さが調整されます。

注意：scrollH プロパティは、scrollV 垂直スクロールプロパティのように 1 から始まるのではなく、0 から始まります。

テキストフィールドのテキストの垂直位置です。scrollV プロパティは、長い文節内の特定の段落にユーザーを誘導したり、スクロールテキストフィールドを作成する場合に便利です。

水平スクロールの単位はピクセル数ですが、垂直スクロールの単位は行数です。表示される最初の行がテキストフィールド内の最初の行の場合、scrollV は 1 に設定されます。0 ではありません。水平スクロールをピクセル単位で指定するのは、フォントのほとんどがプロポーショナルフォントであり、文字の幅が一定でないためです。垂直スクロールの場合は、通常、1 行のテキストの一部だけ表示されるよりも行全体が表示されることが好まれるため、行単位でスクロールします。1 行の中に複数のフォントが存在する場合でも、使用されている最大のフォントに合わせて行の高さが調整されます。

テキストフィールドが選択可能であるかどうかを示すブール値です。値 true は、テキストが選択可能であることを示します。selectable プロパティを使用することで、テキストフィールドが選択可能かどうかを指定できますが、編集可能かどうかは指定できません。ダイナミックテキストフィールドは、編集可能でない場合でも選択可能にすることができます。ダイナミックテキストフィールドが選択可能でない場合、ユーザーはフィールド内のテキストを選択できません。

selectable を false に設定すると、テキストフィールド内のテキストはマウスやキーボードからの選択コマンドに応答しなくなり、「コピー」コマンドを使用してテキストをコピーすることができなくなります。selectable を true に設定すると、テキストフィールド内のテキストはマウスやキーボードを使用して選択できるようになり、「コピー」コマンドを使用してテキストをコピーできるようになります。テキスト入力フィールドではなくダイナミックテキストフィールドの場合でも、この方法でテキストを選択できます。

現在の選択範囲の最初の文字を示す、0 から始まるインデックス値です。例えば、最初の文字が 0、次の文字が 1 と続きます（以下同様）。テキストが選択されていない場合、このプロパティは caretIndex の値になります。

現在の選択範囲における最後の文字を示す、0 から始まるインデックス値です。例えば、最初の文字が 0、次の文字が 1 と続きます（以下同様）。テキストが選択されていない場合、このプロパティは caretIndex の値になります。

このテキストフィールド内の文字エッジのシャープネスです。このプロパティは、テキストフィールドの flash.text.AntiAliasType プロパティが flash.text.AntiAliasType.ADVANCED に設定されている場合にのみ適用されます。sharpness の範囲は -400 ～ 400 の数値です。 sharpness をこの範囲外の値に設定しようとすると、このプロパティは範囲内の最も近い値（-400 または 400）に設定されます。

テキストフィールドにスタイルシートを関連付けます。スタイルシートの作成について詳しくは、StyleSheet クラスおよび『ActionScript 3.0 開発ガイド』を参照してください。

テキストフィールドに関連付けられているスタイルシートは、いつでも変更することができます。使用されているスタイルシートを変更すると、テキストフィールドは新しいスタイルシートを使用して再描画されます。スタイルシートを null または undefined に設定すると、そのスタイルシートを削除できます。使用されているスタイルシートを削除すると、テキストフィールドはスタイルシートを使用せずに再描画されます。

注意：スタイルシートが削除されると、TextField.text および TextField.htmlText の内容は両方とも、以前にスタイルシートで適用したフォーマットを適用するように変更されます。TextField.htmlText の内容をフォーマットなしで保存するには、スタイルシートを削除する前に変数にその値を保存します。

このオブジェクトがタブ順序に含まれるかどうかを指定します。このオブジェクトがタブ順序に含まれる場合、値は true です。含まれない場合、値は false です。デフォルトでは、次の例外を除き、値は false です。

• SimpleButton オブジェクトの場合、この値は true です。
• type = "input" を持つ TextField オブジェクトの場合、値は true です。
• buttonMode = true を持つ Sprite オブジェクトまたは MovieClip オブジェクトの場合、値は true です。

SWF ファイル内のオブジェクトのタブ順序を指定します。デフォルトでは tabIndex プロパティは -1 であり、これはそのオブジェクトにタブインデックスが設定されないことを意味します。

SWF ファイルに現在表示されているオブジェクトに tabIndex プロパティがある場合は、自動タブ順序が無効になり、SWF ファイルのオブジェクトの tabIndex プロパティからタブ順序が計算されます。カスタムタブ順序には、tabIndex プロパティを持つオブジェクトのみが含まれます。

tabIndex プロパティは、通常、負以外の整数です。オブジェクトのタブ順序は、その tabIndex プロパティに従って昇順に決定されます。tabIndex の値が 1 であるオブジェクトは、tabIndex の値が 2 であるオブジェクトの前になります。複数のオブジェクトの tabIndex に同じ値を使用しないでください。

tabIndexプロパティで定義されるカスタムタブ順序は flat です。つまり、SWF ファイル内のオブジェクトの階層関係は無視されます。SWF ファイルで tabIndex プロパティを持つすべてのオブジェクトは、タブ順序に従って配置されます。タブ順序は tabIndex の値の順番に従います。

注意：TLFTextField インスタンスのタブ順序を設定するには、TLFTextField の表示オブジェクトの子を InteractiveObject としてキャストしてから、tabIndex プロパティを設定します。次に実際の使用例を示します。

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

テキストフィールド内の現在のテキストであるストリングです。行は復帰文字（'\r'、ASCII 13）で区切られます。このプロパティは、HTML タグが付いていない、テキストフィールド内のフォーマットなしのテキストを示します。

HTML フォーム内のテキストを取得するには、htmlText プロパティを使用します。

注意：テキストフィールドにスタイルシートが適用されている場合、text プロパティの内容は HTML として解釈されます。

テキストフィールドのテキストの色です（16 進数形式）。16 進数カラーシステムでは、6 桁の数値を使用して色の値を示します。1 つの桁で、16 種類の値（文字）を指定できます。値の範囲は、0 ～ -9、A ～ F です。例えば、黒は 0x000000、白は 0xFFFFFF です。

テキストの高さです（ピクセル単位）。

テキストの幅です（ピクセル単位）。

このテキストフィールド内の文字エッジの太さです。このプロパティは、flash.text.AntiAliasType が flash.text.AntiAliasType.ADVANCED に設定されている場合にのみ適用されます。

thickness の範囲は -200 ～ 200 の数値です。 thickness をこの範囲外の値に設定しようとすると、このプロパティは範囲内の最も近い値（-200 または 200）に設定されます。

テキストフィールドのタイプです。次の TextFieldType 定数のいずれかです。TextFieldType.DYNAMIC はダイナミックテキストフィールドを指定します。このフィールドをユーザーが編集することはできません。TextFieldType.INPUT はテキスト入力フィールドを指定します。このフィールドはユーザーが編集できます。

テキストと共にテキストのフォーマットをコピー＆ペーストするかどうかを指定します。true に設定されている場合、テキストフィールド間でコピー＆ペーストを行うと、Flash Player によってフォーマット（行揃え、ボールド、イタリックなど）もコピー＆ペーストされます。コピー＆ペースト手順のコピー元とペースト先のテキストフィールドの両方で、useRichTextClipboard が true に設定されている必要があります。デフォルト値は false です。

テキストフィールドのテキストを折り返すかどうかを示すブール値です。wordWrap の値が true である場合は、テキストフィールドのテキストを折り返し、false である場合は折り返しません。デフォルト値は false です。

newText パラメーターで指定されたストリングを、テキストフィールドのテキストの最後に付加します。大量の内容が含まれるテキストフィールドの場合は特に、このメソッドを使用するほうが、付加の指定（+=）を text プロパティに加える（someTextField.text += moreText など）よりも効率的です。

パラメーター

文字の境界ボックスである矩形を返します。

パラメーター

x および y パラメーターで指定されたポイントにある文字の 0 から始まるインデックス値を返します。

パラメーター

文字インデックスを指定すると、同じ段落内の最初の文字のインデックスを返します。

パラメーター

指定された id の DisplayObject 参照を返します。<img> タグを使用して HTML フォーマットのテキストフィールドに追加されたイメージまたは SWF ファイルに関するものです。<img> タグは次の書式をとります。

   <img src = 'filename.jpg' id = 'instanceName' >

パラメーター

x および y パラメーターで指定されたポイントにある行の 0 から始まるインデックス値を返します。

パラメーター

charIndex パラメーターで指定された文字を含む行の 0 から始まるインデックス値を返します。

パラメーター

特定のテキスト行内の文字数を返します。

パラメーター

指定されたテキスト行に関するメトリック情報を返します。

パラメーター

lineIndex パラメーターで指定された行の最初の文字の文字インデックスを返します。

パラメーター

lineIndex パラメーターで指定された行のテキストを返します。

パラメーター

文字インデックスを指定すると、指定された文字を含む段落の長さを返します。この長さは、渡された文字インデックスからではなく、段落内の最初の文字からの相対的な長さです。つまり、getFirstCharInParagraph() によって返される長さと同じになります。

パラメーター

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

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

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

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

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

パラメーター

beginIndex および endIndex パラメーターで指定された範囲のテキストのフォーマット情報を含む TextFormat オブジェクトを返します。指定されたテキスト全体に共通するプロパティのみが、結果の TextFormat オブジェクトに設定されます。混在型のプロパティ（テキストの位置によって異なる値が指定されている場合）は、その値が null に設定されます。

これらのパラメーターに値を指定しない場合、このメソッドはテキストフィールド内のすべてのテキストに適用されます。

次の表に、使用できる 3 つのシンタックスを示します。

パラメーター

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

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

現在の選択内容を value パラメーターの内容に置き換えます。テキストは、現在のデフォルトの文字フォーマットとデフォルトの段落フォーマットを使用して、現在の選択内容の位置に挿入されます。テキストは HTML として扱われません。

replaceSelectedText() メソッドを使用すると、他の部分のテキストの文字フォーマットおよび段落フォーマットを損なわずにテキストを挿入および削除できます。

注意：このメソッドは、テキストフィールドにスタイルシートが適用されていると機能しません。

パラメーター

beginIndex パラメーターと endIndex パラメーターで指定された文字範囲を、newText パラメーターの内容に置き換えます。意図したとおり、beginIndex から endIndex-1 までのテキストが置き換えられます。

注意：このメソッドは、テキストフィールドにスタイルシートが適用されていると機能しません。

パラメーター

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

パラメーター

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

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

最初の文字と最後の文字のインデックス値によって指定されたテキストを選択済みに設定します。最初の文字と最後の文字のインデックス値は、beginIndex および endIndex パラメーターを使用して指定されます。2 つのパラメーター値が同じ場合、このメソッドは、caretIndex プロパティを設定した場合と同様に挿入ポイントを設定します。

パラメーター

format パラメーターで指定したテキストフォーマットを、テキストフィールド内の指定されたテキストに適用します。format の値は、必要なテキストフォーマットの変更を指定する TextFormat オブジェクトである必要があります。format の null 以外のプロパティのみが、テキストフィールドに適用されます。format で null に設定されているプロパティは適用されません。デフォルトで、新しく作成された TextFormat オブジェクトのプロパティはすべて null に設定されます。

注意：このメソッドは、テキストフィールドにスタイルシートが適用されていると機能しません。

setTextFormat() メソッドは、テキストフィールドの文字の範囲またはテキスト全体に適用するテキストフォーマットを変更します。フォーマットのプロパティをテキストフィールド内のすべてのテキストに適用するには、beginIndex および endIndex に値を指定しないでください。フォーマットのプロパティをテキストの範囲に適用するには、beginIndex および endIndex パラメーターに値を指定します。length プロパティを使用して、インデックス値を指定できます。

TextFormat オブジェクトのフォーマット情報には、文字レベルフォーマットと段落レベルフォーマットの 2 種類があります。テキストフィールド内の各文字にも、フォント名やフォントサイズ、ボールド、イタリックなどの文字固有のフォーマットを設定できます。

段落の場合は、段落の最初の文字を調べて段落全体のフォーマット設定を判別します。段落のフォーマット設定には、左インデント、右インデント、一行目インデントなどがあります。

ユーザーによって手作業で挿入されたテキスト、または replaceSelectedText() メソッドを使用して置き換えられたテキストは、テキストの挿入か所に指定されているフォーマットではなく、新しいテキスト用のテキストフィールドのデフォルトフォーマットが適用されます。新しいテキスト用のデフォルトフォーマットを設定するには、defaultTextFormat を使用します。

パラメーター

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

パラメーター