使用 TextInput 组件

在应用程序中，TextInput 组件可以被启用或者禁用。在禁用状态下，该组件不接收鼠标或键盘输入。当启用时，它遵循与 ActionScript TextField 对象相同的焦点、选择和导航规则。当一个 TextInput 实例有焦点时，您还可以使用以下按键来控制它：

有关控制焦点的详细信息，请参阅 《用于 Adobe® Flash® Professional CS5 的 ActionScript® 3.0 参考》 中的 FocusManager 类以及 使用 FocusManager 。

每个 TextInput 实例的实时预览反映在创作过程中对“属性”检查器或“组件”检查器中的参数所做的更改。在实时预览中，文本是不可选定的，并且无法在舞台上的组件实例中输入文本。

在将 TextInput 组件添加到应用程序时，您可以使用“辅助功能”面板来使其可由屏幕读取器访问。

您可以在“属性”检查器或“组件”检查器中为每个 TextInput 组件实例设置下列创作参数： editable 、 displayAsPassword 、 maxChars 、 restrict 和 text 。其中每个参数都有对应的同名 ActionScript 属性。有关这些参数的可能值的信息，请参阅 《用于 Adobe® Flash® Professional CS5 的 ActionScript® 3.0 参考》 中的 TextInput 类。

您可以编写 ActionScript，通过利用 TextInput 组件的属性、方法和事件来控制该组件的这些选项以及其他选项。有关详细信息，请参阅 《用于 Adobe® Flash® Professional CS5 的 ActionScript® 3.0 参考》 中的 TextInput 类。

以下过程解释了如何将 TextInput 组件添加到应用程序。此示例使用两个 TextInput 字段来接收和确认密码。它使用一个事件侦听器来查看输入的字符数是否不少于八位以及这两个字段的文本是否匹配。

1. 创建一个新的 Flash (ActionScript 3.0) 文档。

2. 将一个 Label 组件从“组件”面板拖到舞台上，并在“属性”检查器中为该组件输入以下值：

   • 输入实例名称 pwdLabel 。

   • 为 W 输入值 100 。

   • 为 X 输入值 50 。

   • 为 Y 输入值 150 。

   • 在“参数”部分中，为 text 参数输入值 Password: 。

3. 从“组件”面板将第二个 Label 组件拖到舞台上并为它分配以下值：

   • 输入实例名称 confirmLabel 。

   • 为 W 输入值 100 。

   • 为 X 输入值 50 。

   • 为 Y 输入值 200 。

   • 在“参数”部分中，为 text 参数输入值 Confirm Password: 。

4. 从“组件”面板将 TextInput 组件拖到舞台上并为它分配以下值：

   • 输入实例名称 pwdTi 。

   • 为 W 输入值 150 。

   • 为 X 输入值 190 。

   • 为 Y 输入值 150 。

   • 在“参数”部分中，双击 displayAsPassword 参数的值，然后选择 true 。这样，就会用星号掩盖文本字段中输入的值。

5. 从“组件”面板将另一个 TextInput 组件拖到舞台上并为它分配以下值：

   • 输入实例名称 confirmTi 。

   • 为 W 输入值 150 。

   • 为 X 输入值 190 。

   • 为 Y 输入值 200 。

   • 在“参数”部分中，双击 displayA s Password 参数的值，然后选择 true 。这样，就会用星号掩盖文本字段中输入的值。

6. 打开“动作”面板，在主时间轴中选择第 1 帧，然后输入以下 ActionScript 代码：

   function tiListener(evt_obj:Event){ 
   if(confirmTi.text != pwdTi.text || confirmTi.length < 8) 
   { 
           trace("Password is incorrect. Please reenter it."); 
   }  
   else { 
           trace("Your password is: " + confirmTi.text); 
   } 
   } 
   confirmTi.addEventListener("enter", tiListener);

   此代码在名为 confirmTi 的 TextInput 实例上设置 enter 事件处理函数。如果这两个密码不匹配或者用户键入的字符数少于八位，此示例将显示消息：“密码不正确。请重新输入。”如果密码为八位或八位以上并且互相匹配，此示例将在“输出”面板中显示输入的值。

7. 选择“控制”>“测试影片”。