Uso del componente TextArea

Es posible activar o desactivar el componente TextArea en una aplicación. En el estado desactivado, no puede recibir entradas del ratón ni del teclado. Cuando está activado, sigue las mismas reglas de selección y navegación que un objeto TextField de ActionScript. Cuando una instancia de TextArea está seleccionada, se puede controlar mediante las teclas siguientes:

Para obtener más información sobre el control de la selección, consulte la clase FocusManager en la Referencia de ActionScript 3.0 para Flash Professional y en Trabajo con FocusManager .

Puede establecer los siguientes parámetros de edición para cada instancia del componente TextArea en el inspector de propiedades o en el inspector de componentes: condenseWhite , editable , hortizontalScrollPolicy , maxChars , restrict , text , verticalScrollPolicy y wordwrap . Cada uno de estos parámetros tiene una propiedad de ActionScript del mismo nombre. Para obtener información los valores posibles de estos parámetros, consulte la clase TextArea en la Referencia de ActionScript 3.0 para Flash Professional .

La previsualización dinámica de cada instancia de TextArea refleja los cambios de parámetros realizados durante la edición en el inspector de propiedades o el inspector de componentes. Si se necesita una barra de desplazamiento, ésta aparece en la previsualización dinámica, aunque no funciona. No es posible seleccionar texto en la previsualización dinámica, de igual modo que tampoco se puede introducir texto en la instancia del componente en el escenario.

Es posible escribir código ActionScript para controlar éstas y otras opciones adicionales para el componente TextArea mediante sus propiedades, métodos y eventos. Para obtener más información, consulte la clase TextArea en la Referencia de ActionScript 3.0 para Flash Professional .

El procedimiento siguiente explica cómo añadir un componente TextArea a una aplicación durante la edición. En el ejemplo, se configura un controlador de eventos focusOut en la instancia de TextArea que verifica que el usuario ha escrito algo en el área de texto antes de seleccionar una parte diferente de la interfaz.

1. Cree un nuevo documento de Flash (ActionScript 3.0).

2. Arrastre un componente TextArea del panel Componentes al escenario y asígnele el nombre de instancia aTa . Deje los parámetros establecidos en las opciones predeterminadas.

3. Arrastre un segundo componente TextArea del panel Componentes al escenario, colóquelo debajo del primero y asígnele el nombre de instancia bTa . Deje los parámetros establecidos en las opciones predeterminadas.

4. Abra el panel Acciones, seleccione el fotograma 1 en la línea de tiempo principal e introduzca el código ActionScript siguiente:

   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(); 
   }

   En este ejemplo se limitan los caracteres que se pueden introducir en el área de texto aTa a caracteres en minúscula, comas, apóstrofes y espacios. También se configuran los controladores de eventos para los eventos change , KEY_FOCUS_CHANGE y MOUSE_FOCUS_CHANGE en el área de texto aTa. La función changeHandler() hace que el texto introducido en el área de texto aTa aparezca automáticamente en el área de texto bTa , mediante la asignación de aTa.text a bTa.text en cada evento change. La función k_m_fHandler() de los eventos KEY_FOCUS_CHANGE y MOUSE_FOCUS_CHANGE impide presionar la tecla Tabulador para desplazarse al siguiente campo sin introducir texto. Para ello, se impide el comportamiento predeterminado.

5. Seleccione Control > Probar película.

   Si se presiona la tecla Tabulador para seleccionar la segunda área de texto sin introducir texto, aparecerá un mensaje de error y la selección deberá volver a la primera área de texto. A medida que se introduce texto en la primera área de texto, se verá duplicado en la segunda área de texto.