使用 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. 将第二个 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 键将焦点移到第二个文本区域，则会显示一条错误消息，且焦点应当回到第一个文本区域。当您在第一个文本区域中输入文本时，可以看到这些文本同时也出现在第二个文本区域中。