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

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

次の図に 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>
前の例で実行する SWF ファイルは以下のとおりです。

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

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

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