TextArea の使用

TextArea コンポーネントは、ネイティブの ActionScript TextField オブジェクトのラッパーです。TextArea コンポーネントは、テキストの表示に使用できます。また、editable プロパティが true の場合は、テキスト入力の編集や受け取りにも使用できます。このコンポーネントでは、複数行のテキストを表示または入力することができます。wordWrap プロパティが true に設定されていると、行数の多いテキストが折り返されます。restrict プロパティを使用すると、ユーザーが入力できる文字を制限することができます。また、maxChars を使用すると、ユーザーが入力できる最大文字数を指定することができます。テキストが、テキスト領域の水平方向または垂直方向の範囲を超えた場合は、水平スクロールバーまたは垂直スクロールバーが自動的に表示されます。ただし、テキスト領域に関連付けられたプロパティである horizontalScrollPolicy と verticalScrollPolicy が off に設定されている場合は表示されません。

TextArea コンポーネントは、複数行のテキストフィールドが必要な場所ならどこでも使用できます。たとえば、TextArea コンポーネントをフォームのコメントフィールドに使用することが考えられます。また、ユーザーが Tab キーでフィールドの外に移動したときに、フィールドが空かどうかをチェックするリスナーをセットアップすることができます。このリスナーを使うと、フィールドにコメントを入力する必要があることをユーザーに知らせるエラーメッセージを表示できます。

単一行のテキストフィールドが必要な場合は、TextInput コンポーネントを使用します。

setStyle() メソッドを使用して textFormat スタイルを設定すると、TextArea インスタンスに表示するテキストのスタイルを変更できます。ActionScript で htmlText プロパティを使用すると、TextArea コンポーネントを HTML でフォーマットすることもできます。また、displayAsPassword プロパティを true に設定すると、テキストをアスタリスクでマスクすることもできます。condenseWhite プロパティを true に設定すると、スペースや改行などによる余分な空白が新しいテキストから削除されます。これは、既にコントロールに入力済みのテキストでは無効です。

TextArea の使用

関連トピック