Arbeiten mit der TextArea-Komponente

TextArea-Komponenten können in einer Anwendung aktiviert und deaktiviert werden. In deaktiviertem Zustand werden Eingaben über die Maus oder die Tastatur nicht angenommen. In aktiviertem Zustand gelten für dieses Objekt dieselben Fokus-, Auswahl- und Navigationsregeln wie für das ActionScript-Objekt „TextField“. Wenn eine TextArea-Instanz den Fokus hat, können Sie diese mithilfe der folgenden Tasten steuern:

Weitere Informationen zum Steuern des Fokus finden Sie im Abschnitt zur FocusManager-Klasse im ActionScript 3.0 Referenzhandbuch für Flash Professional und unter Arbeiten mit dem FocusManager .

Die folgenden Authoring-Parameter können für jede Instanz der TextArea-Komponente im Eigenschaften- oder Komponenten-Inspektor festgelegt werden: condenseWhite , editable , hortizontalScrollPolicy , maxChars , restrict , text , verticalScrollPolicy und wordwrap . Jeder dieser Parameter verfügt über eine entsprechende ActionScript-Eigenschaft mit demselben Namen. Informationen zu den möglichen Werten für diese Parameter finden Sie im Abschnitt zur TextArea-Klasse im ActionScript 3.0 Referenzhandbuch für Flash Professional .

Die Änderungen an den Parametern der einzelnen TextArea-Instanzen, die beim Authoring im Eigenschaften- oder Komponenteninspektor vorgenommen werden, werden jeweils in einer Live-Vorschau angezeigt. Wenn eine Bildlaufleiste benötigt wird, wird diese in der Vorschau zwar angezeigt, funktioniert jedoch nicht. Außerdem kann in der Live-Vorschau weder Text ausgewählt noch Text in der Komponenteninstanz auf der Bühne eingegeben werden.

Mithilfe von ActionScript können Sie diese und weitere Optionen für die TextArea-Komponente über ihre Eigenschaften, Methoden und Ereignisse steuern. Weitere Informationen finden Sie im Abschnitt zur TextArea-Klasse im ActionScript 3.0 Referenzhandbuch für Flash Professional .

In der folgenden Anleitung wird erläutert, wie beim Authoring eine TextArea-Komponente in eine Anwendung eingefügt wird. Im Beispiel wird die Ereignisprozedur focusOut für die TextArea-Instanz eingerichtet. Die Prozedur überprüft, ob der Benutzer etwas in das Textfeld eingegeben hat, bevor der Fokus auf einen anderen Teil der Benutzeroberfläche gelegt wird.

1. Erstellen Sie ein neues Flash-Dokument (ActionScript 3.0).

2. Ziehen Sie eine TextArea-Komponente vom Bedienfeld „Komponenten“ auf die Bühne und nennen Sie die Instanz aTa . Übernehmen Sie für alle Parameter die Standardeinstellungen.

3. Ziehen Sie eine zweite TextArea-Komponente aus dem Bedienfeld „Komponenten“ auf die Bühne, platzieren Sie sie unter der ersten und nennen Sie die Instanz bTa . Übernehmen Sie für alle Parameter die Standardeinstellungen.

4. Öffnen Sie das Bedienfeld „Aktionen“, wählen Sie in der Hauptzeitleiste Bild 1 aus und geben Sie den folgenden ActionScript-Code ein:

   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 diesem Beispiel werden die im Textbereich aTa zulässigen Zeichen auf Kleinbuchstaben, das Komma, das Hochkomma (Apostroph) und Leerzeichen beschränkt. Zudem werden zum Textbereich aTa Ereignisprozeduren für die Ereignisse change , KEY_FOCUS_CHANGE und MOUSE_FOCUS_CHANGE eingerichtet. Die Funktion changeHandler() bewirkt, dass der Text, der in das Textfeld aTa eingegeben wird, automatisch im Textfeld bTa angezeigt wird, indem aTa.text bei jedem change -Ereignis bTa.text zugewiesen wird. Die Funktion k_m_fHandler() für die Ereignisse KEY_FOCUS_CHANGE und MOUSE_FOCUS_CHANGE verhindert, dass der Benutzer die Tabulatortaste drücken kann, um den Fokus auf das nächste Steuerelement zu setzen, ohne vorher Text einzugeben. Dies wird erreicht, indem das Standardverhalten verhindert wird.

5. Wählen Sie „Steuerung“ > „Film testen“.

   Wenn Sie die Tabulatortaste drücken, um den Fokus in den zweiten Textbereich zu setzen, ohne Text einzugeben, wird eine Fehlermeldung angezeigt und der Fokus kehrt zurück auf den ersten Textbereich. Während Sie in den ersten Textbereich Text eingeben, können Sie sehen, dass er im zweiten Textbereich dupliziert wird.