TextArea コンポーネントの使用

アプリケーション内で TextArea コンポーネントを有効または無効にすることができます。 無効状態のときは、マウスおよびキーボードからの入力を受け付けることができません。 有効状態のときは、ActionScript TextField オブジェクトと同じフォーカス、選択、およびナビゲーションの規則に従います。 フォーカスを取得している TextArea インスタンスでは、次のキーを使用した操作が可能です。

フォーカスの制御について詳しくは、「 Adobe Flash Professional CS5 用 ActionScript 3.0 リファレンスガイド 」の FocusManager クラスおよび FocusManager の操作 を参照してください。

プロパティインスペクターまたはコンポーネントインスペクターで、TextArea コンポーネントの各インスタンスに設定できるオーサリングパラメーターは、 condenseWhite 、 editable 、 hortizontalScrollPolicy 、 maxChars 、 restrict 、 text 、 verticalScrollPolicy および wordwrap です。これらの各パラメーターには、対応する同名の ActionScript プロパティがあります。これらのパラメーターに設定できる値については、「 Adobe Flash Professional CS5 用 ActionScript 3.0 リファレンスガイド 」の TextArea クラスを参照してください。

各 TextArea インスタンスのライブプレビューには、オーサリング時にプロパティインスペクターまたはコンポーネントインスペクターでパラメーターに加えた変更が反映されます。 スクロールバーが必要な場合は、ライブプレビューに表示されますが、このスクロールバーは機能しません。 ライブプレビューではテキストを選択できず、ステージ上のコンポーネントインスタンスにテキストを入力することはできません。

ActionScript を記述すれば、TextArea コンポーネントのプロパティ、メソッド、イベントを使用して、これらのオプションやその他のオプションを制御できます。 詳しくは、「 Adobe Flash Professional CS5 用 ActionScript 3.0 リファレンスガイド 」の TextArea クラスを参照してください。

次の手順は、オーサリング時に TextArea コンポーネントをアプリケーションに追加する方法を示しています。 この例では、TextArea インスタンスの focusOut イベントハンドラーをセットアップします。このイベントハンドラーは、インターフェイスの別の場所にフォーカスを移す前に、ユーザーがテキスト領域に入力したかどうかを確認します。

1. 新しい Flash ドキュメント (ActionScript 3.0) を作成します。

2. TextArea コンポーネントをコンポーネントパネルからステージまでドラッグし、インスタンス名を aTa にします。パラメーターは、デフォルト設定のままにします。

3. 2 番目の TextArea コンポーネントをコンポーネントパネルからステージまでドラッグし、1 番目のコンポーネントの下に配置して、インスタンス名を bTa にします。パラメーターは、デフォルト設定のままにします。

4. アクションパネルを開いて、メインタイムライン内でフレーム 1 を選択し、次の ActionScript コードを入力します。

   import flash.events.FocusEvent; 
    
   aTa.restrict = "a-z,'\" \""; 
   aTa.addEventListener(Event.CHANGE,changeHandler); 
   aTa.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, k_m_fHandler); 
   aTa.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, k_m_fHandler); 
    
   function changeHandler(ch_evt:Event):void { 
       bTa.text = aTa.text; 
   } 
   function k_m_fHandler(kmf_event:FocusEvent):void { 
       kmf_event.preventDefault(); 
   }

   この例では、 aTa テキスト領域に入力できる文字を、小文字、コンマ、アポストロフィおよびスペースに制限しています。また、 aTa テキスト領域の change 、 KEY_FOCUS_CHANGE および MOUSE_FOCUS_CHANGE の各イベントのイベント ハンドラーも設定します。 changeHandler() 関数によって、各 change イベントの発生時に aTa.text を bTa.text に割り当てることで、 aTa テキスト領域に入力するテキストが bTa テキスト領域に自動的に表示されます。 KEY_FOCUS_CHANGE イベントと MOUSE_FOCUS_CHANGE イベントの k_m_fHandler() 関数は、ユーザーがテキストを入力しないまま Tab キーを押して次のフィールドに移動できないようにします。この動作は、デフォルトのビヘイビアーを回避することで実行されます。

5. 制御／ムービープレビューを選択します。

   テキストを入力せずに Tab キーを押して 2 番目のテキスト領域にフォーカスを移動した場合は、エラーメッセージが表示され、1 番目のテキスト領域にフォーカスが戻ります。 1 番目のテキスト領域にテキストを入力すると、そのテキストが複製されて 2 番目のテキスト領域に表示されます。