De component TextArea gebruiken

Een component TextArea kan worden in- of uitgeschakeld in een toepassing. In de uitgeschakelde toestand kan de component geen muis- of toetsenbordinvoer ontvangen. Wanneer de component is ingeschakeld, volgt deze dezelfde focus-, selectie- en navigatieregels als een ActionScript-object TextField. Wanneer een instantie TextArea focus heeft, kunt u de volgende toetsen gebruiken om de instantie te beheren:

Zie de klasse FocusManager in de Naslaggids voor ActionScript 3.0 voor Adobe Flash Professional CS5 en Werken met FocusManager voor meer informatie over focusbeheer.

U kunt in Eigenschapcontrole of Componentcontrole de volgende ontwerpparameters instellen voor elke instantie van de component TextArea: condenseWhite , editable , hortizontalScrollPolicy , maxChars , restrict , text , verticalScrollPolicy en wordwrap . Elk van deze parameters heeft een bijbehorende ActionScript-eigenschap met dezelfde naam. Zie de klasse TextArea in de Naslaggids voor ActionScript 3.0 voor Adobe Flash Professional CS5 voor informatie over de mogelijk waarden voor deze parameters.

Een live voorvertoning van elke instantie TextArea geeft direct wijzigingen weer in parameters in Eigenschapcontrole of Componentcontrole tijdens het ontwerpen. Wanneer een schuifbalk nodig is, wordt deze wel in de live voorvertoning weergegeven maar werkt deze niet. In de live voorvertoning is tekst niet selecteerbaar en u kunt in de componentinstantie in het werkgebied geen tekst invoeren.

U kunt ActionScript-code schrijven om deze en aanvullende opties voor de component TextArea te beheren met de eigenschappen, methoden en gebeurtenissen ervan. Zie de klasse TextArea in de Naslaggids voor ActionScript 3.0 voor Adobe Flash Professional CS5 voor meer informatie.

De volgende procedure laat zien hoe u een component TextArea tijdens het ontwerpen aan een toepassing kunt toevoegen. In het voorbeeld wordt een gebeurtenishandler focusOut op de instantie TextArea ingesteld. Die controleert of de gebruiker iets in het tekstgebied typt voordat de focus aan een ander deel van de interface wordt gegeven.

1. Maak een nieuw Flash-document (ActionScript 3.0).

2. Sleep een component TextArea van het deelvenster Componenten naar het werkgebied en geef deze de instantienaam aTa . Laat de parameters op de standaardinstellingen staan.

3. Sleep een tweede component TextArea van het deelvenster Componenten naar het werkgebied, plaats deze onder de eerste en geef de component de instantienaam bTa . Laat de parameters op de standaardinstellingen staan.

4. Open het deelvenster Handelingen, selecteer frame 1 van de hoofdtijdlijn en voeg de volgende ActionScript-code toe:

   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 dit voorbeeld wordt het aantal tekens dat in het tekstgebied aTa kan worden ingevoerd, beperkt tot kleine letters, komma’s, apostrofs en spaties. Bovendien worden gebeurtenishandlers voor de gebeurtenissen change , KEY_FOCUS_CHANGE en MOUSE_FOCUS_CHANGE op het tekstgebied aTa ingesteld. De functie changeHandler() zorgt dat de tekst die in het tekstgebied aTa wordt ingevoerd, automatisch in het tekstgebied bTa wordt weergegeven door aTa.text aan bTa.text toe te wijzen bij elke gebeurtenis change . De functie k_m_fHandler() voor de gebeurtenissen KEY_FOCUS_CHANGE en MOUSE_FOCUS_CHANGE zorgt dat de gebruiker niet met Tab naar het volgende veld kan gaan zonder eerst tekst in te voeren. Dit wordt bewerkstelligd door het standaardgedrag te voorkomen.

5. Selecteer Besturing > Film testen.

   Wanneer u op Tab drukt om de focus naar het tweede tekstgebied te verplaatsen zonder tekst in te voeren, wordt een foutbericht weergegeven en keert de focus terug naar het eerste tekstgebied. Terwijl u in het eerste tekstgebied tekst invoert, wordt deze in het tweede tekstgebied weergegeven.