使用 TextArea 組件

應用程式可以啟用或停用 TextArea 組件。處於停用狀態時，便不接受滑鼠或鍵盤輸入。若處於啟用狀態，則其焦點、選取範圍和導覽規則如同 ActionScript TextField 物件。當 TextArea 實體成為焦點時，您可以使用下列按鍵加以控制：

如需有關控制焦點的詳細資訊，請參閱 Flash Professional 的 ActionScript 3.0 參考 中的「FocusManager 類別」，以及 使用 FocusManager 。

您可以在「屬性」檢測器或「組件檢測器」中，為每個 TextArea 組件實體設定下列編寫參數： condenseWhite 、 editable 、 hortizontalScrollPolicy 、 maxChars 、 restrict 、 text 、 verticalScrollPolicy 和 wordwrap 。這些參數都具有相對應的 ActionScript 同名屬性。如需有關這些參數可能值的詳細資訊，請參閱 適用於 Adobe Flash Platform 的 ActionScript 3.0 參考 中的 TextArea 類別。

進行編寫時，每個 TextArea 實體的即時預覽會反映您在「屬性」檢測器或「組件檢測器」面板中對參數的變更。若有需要，捲軸會出現在即時預覽中，但是在即時預覽中沒有作用。即時預覽時無法選取文字，也不能將文字輸入「舞台」上的組件實體。

您可以撰寫 ActionScript 利用 TextArea 組件的屬性、方法和事件，來控制上列各種選項及其它選項。如需詳細資訊，請參閱 適用於 Adobe Flash Platform 的 ActionScript 3.0 參考 中的 TextArea 類別。

下列程序說明如何在編寫時將 TextArea 組件加入應用程式。此範例會對 TextArea 實體設定 focusOut 事件處理常式，以確認使用者將焦點移至介面的其它部分之前，是否已在文字區域中輸入了一些內容。

1. 建立新的 Flash 文件 (ActionScript 3.0)。

2. 將 TextArea 組件從「組件」面板拖曳到「舞台」，並賦予實體名稱 aTa 。所有參數設定均保留預設值。

3. 將第二個 TextArea 組件從「組件」面板拖曳到「舞台」，置於第一個 TextArea 組件下方，並賦予實體名稱 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 鍵將焦點移到第二個文字區域，則會出現錯誤訊息，且焦點將返回第一個文字區域。當您在第一個文字區域中輸入文字時，第二個文字區域會重製該文字。