Uso do componente TextArea

Um componente TextArea pode estar ativado ou desativado em um aplicativo. No estado desativado, ele não pode receber entradas de mouse nem de teclado. Quando ativado, ele segue as mesmas regras de foco, seleção e navegação que o objeto TextField do ActionScript. Quando uma ocorrência de TextArea estiver com o foco, você poderá controlá-la usando as seguintes teclas:

Para obter mais informações sobre o controle do foco, consulte a classe FocusManager na Referência do ActionScript 3.0 para Flash Professional e Trabalho com o FocusManager .

Você pode definir os parâmetros de autoria a seguir para cada instância do componente TextArea no Inspetor de propriedades ou no Inspetor e componentes: condenseWhite , editable , hortizontalScrollPolicy , maxChars , restrict , text , verticalScrollPolicy e wordwrap . Cada um desses parâmetros tem uma propriedade ActionScript correspondente de mesmo nome. Para obter informações sobre os possíveis valores desses parâmetros, consulte a classe TextArea na Referência do ActionScript 3.0 para Flash Professional .

Uma visualização ao vivo de cada ocorrência de TextArea reflete as alterações feitas nos parâmetros no Inspetor de propriedades ou no Inspetor de componentes durante a criação. Se uma barra de rolagem for necessária, ela aparecerá na visualização ao vivo, mas não funcionará. O texto não pode ser selecionado na visualização ao vivo, e não é possível digitar texto na ocorrência do componente no Palco.

Você pode escrever o ActionScript de modo a controlar essas e outras opções do componente TextArea usando suas propriedades, métodos e eventos. Para obter mais informações, consulte a classe TextArea na Referência do ActionScript 3.0 para Flash Professional .

O procedimento a seguir explica como adicionar um componente TextArea a um aplicativo durante a criação. O exemplo configura um manipulador de eventos focusOut na ocorrência de TextArea que verifica se o usuário digitou algo na área de texto antes de atribuir o foco a uma parte diferente da interface.

1. Crie um novo documento Flash (ActionScript 3.0).

2. Arraste um componente TextArea do painel Componentes para o Palco e atribua a ele o nome de ocorrência aTa . Deixe seus parâmetros definidos com as configurações padrão.

3. Arraste um segundo componente TextArea do painel Componentes para o Palco, coloque-o abaixo do primeiro e atribua a ele o nome de ocorrência bTa . Deixe seus parâmetros definidos com as configurações padrão.

4. Abra o painel Ações, selecione Quadro 1 na Linha do tempo principal e digite o seguinte código do 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(); 
   }

   Este exemplo restringe os caracteres digitados na área de texto aTa a caracteres minúsculos, vírgula, apóstrofo e espaços. Ele também configura os manipuladores dos eventos change , KEY_FOCUS_CHANGE e MOUSE_FOCUS_CHANGE na área de texto aTa . A função changeHandler() faz com que o texto digitado na área de texto aTa apareça automaticamente na área de texto bTa , atribuindo aTa.text a bTa.text em cada evento change . A função k_m_fHandler() dos eventos KEY_FOCUS_CHANGE e MOUSE_FOCUS_CHANGE impede que você pressione a tecla Tab para mover-se para o campo seguinte sem digitar nenhum texto. Ele faz isso impedindo o comportamento padrão.

5. Selecione Controlar > Testar filme.

   Se você pressionar a tecla Tab para mover o foco para a segunda área de texto sem digitar nenhum texto, uma mensagem de erro será exibida e o foco deverá retornar para a primeira área de texto. Quando você digitar texto na primeira área de texto, o verá duplicado na segunda área de texto.