TextArea コントロール -- Flex 2.01

TextArea コントロールは、境界線とスクロールバー (オプション) を持つ、複数行に対応した編集可能なテキストフィールドです。TextArea コントロールでは、Flash Player の HTML とリッチテキストのレンダリング機能がサポートされています。TextArea コントロールは、change イベントおよび textInput イベントを送出します。

詳細については、『Adobe Flex 2 リファレンスガイド』の TextArea を参照してください。

編集可能な単一行のテキストフィールドを作成する場合は、TextInput コントロールを使用します。詳細については、TextInput コントロールを参照してください。編集不可のテキストフィールドを作成するには、Label および Text コントロールを使用します。詳細については、Label コントロールおよびText コントロールを参照してください。

TextArea コントロールを無効にした場合、その内容は disabledColor スタイルで指定した色で表示されます。TextArea コントロールの editable プロパティを false に設定すると、テキストの編集を防止できます。TextArea コントロールの displayAsPassword プロパティを設定すると、入力文字をアスタリスクで表示することにより、入力テキストを隠すことができます。

サブトピック

TextArea コントロールの作成

TextArea コントロールは、次の例に示すように、<mx:TextArea> タグを使用して MXML 内で定義します。MXML の他の場所 (他のタグまたは ActionScript ブロック) のコントロールを参照する場合は、id 値を指定します。

<?xml version="1.0"?>
<!-- textcontrols/TextAreaControl.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
  <mx:TextArea id="textConfirm" width="300" height="100" text="Please enter your thoughts here."/>
</mx:Application>

Text コントロールと同様、純粋なテキストだけのストリングを指定する場合は text プロパティを使用し、HTML 形式のストリングを指定する場合は htmlText プロパティを使用します。詳細については、text プロパティの使用およびhtmlText プロパティの使用を参照してください。

TextArea コントロールのサイズ設定

TextArea コントロールには、次のデフォルトのサイズ変更プロパティがあります。

プロパティ	デフォルト値
デフォルトサイズ	`width` プロパティは 160 ピクセル `height` プロパティは 44 ピクセル
最小サイズ	0
最大サイズ	10000 x 10000 ピクセル

TextArea コントロールは、含まれているテキストに合わせてサイズ変更されません。新規のテキストが TextArea コントロールの容量を超え、かつ horizontalScrollPolicy が true (デフォルト値) の場合は、コントロールによりスクロールバーが追加されます。