Usare il componente TextArea

Un componente TextArea può essere abilitato o disabilitato in un'applicazione: Quando è disattivato, non può ricevere input dal mouse o dalla tastiera. Quando è abilitato, segue le stesse regole di attivazione e di navigazione di un oggetto TextField di ActionScript. Quando un'istanza del componente TextArea è attiva, potete usare i seguenti tasti per controllarla:

Per ulteriori informazioni sul controllo dell'attivazione, vedete la classe FocusManager nella Guida di riferimento di ActionScript 3.0 per Flash Professional e Operazioni con FocusManager .

Potete impostare i parametri di creazione seguenti per ogni istanza del componente TextArea nella finestra di ispezione Proprietà o nella finestra di ispezione dei componenti: condenseWhite , editable , hortizontalScrollPolicy , maxChars , restrict , text , verticalScrollPolicy e wordwrap . Ciascuno di questi parametri ha una proprietà ActionScript corrispondente con lo stesso nome. Per informazioni sui valori che potete impostare per questi parametri, vedete la classe TextArea nella Guida di riferimento di ActionScript 3.0 per Flash Professional .

Nell'anteprima dal vivo di ogni istanza di TextArea vengono visualizzate le modifiche apportate ai parametri nella finestra di ispezione Proprietà o nella finestra di ispezione dei componenti durante la creazione. Se è necessaria una barra di scorrimento, nell'anteprima dal vivo viene visualizzata ma non funziona. Il testo non è selezionabile nell'anteprima dal vivo e non è possibile immetterlo nell'istanza del componente sullo stage.

È possibile creare codice ActionScript per controllare queste e altre opzioni per il componente TextArea utilizzandone le proprietà, i metodi e gli eventi. Per ulteriori informazioni, vedete la classe TextArea nella Guida di riferimento di ActionScript 3.0 per Flash Professional .

La procedura seguente indica come aggiungere un componente TextArea a un'applicazione durante la creazione. L'esempio imposta sull'istanza TextArea un gestore di eventi focusOut che verifica che l'utente abbia digitato dei caratteri nel campo di testo prima di attivare una parte diversa dell'interfaccia.

1. Create un nuovo documento Flash (ActionScript 3.0).

2. Trascinate un componente TextArea dal pannello Componenti allo stage e assegnategli il nome di istanza aTa . Lasciate invariate le impostazioni predefinite dei parametri.

3. Trascinate un secondo componente TextArea dal pannello Componenti allo stage, posizionatelo sotto il primo e assegnategli il nome di istanza aTa . Lasciate invariate le impostazioni predefinite dei parametri.

4. Aprite il pannello Azioni, selezionate il fotogramma 1 nella linea temporale principale, quindi immettete il codice ActionScript seguente:

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

   In questo esempio i caratteri che potete inserire nell'area di testo aTa vengono limitati a caratteri minuscoli, virgola, apostrofo e spazi. Vengono inoltre impostati i gestori di eventi per gli eventi change , KEY_FOCUS_CHANGE e MOUSE_FOCUS_CHANGE dell'area di testo aTa . La funzione changeHandler() causa la visualizzazione automatica del testo inserito nell'area di testo aTa nell'area di testo bTa , mediante l'assegnazione di aTa.text a bTa.text per ogni evento change . La funzione k_m_fHandler() per gli eventi KEY_FOCUS_CHANGE e MOUSE_FOCUS_CHANGE impedisce all'utente di premere il tasto Tab per passare al campo successivo senza avere inserito del testo. Questa impostazione impedisce l'esecuzione del comportamento predefinito.

5. Selezionare Controllo > Prova filmato.

   Se premete il tasto Tab per attivare la seconda area di testo senza inserire del testo, viene visualizzato un messaggio di errore e viene riattivata la prima area di testo. Se inserite del testo nella prima area di testo, questo viene duplicato nella seconda area di testo.