Korzystanie ze składnika TextArea

Składnik TextArea może być włączony lub wyłączony. W stanie disabled składnik TextArea nie odbiera danych wprowadzanych za pomocą klawiatury lub myszy. Po włączeniu (stan enabled) dla tego składnika obowiązują te same reguły aktywacji, zaznaczania i nawigacji, które obowiązują dla obiektu TextField języka ActionScript. Po aktywowaniu instancji TextArea można nią sterować za pomocą następujących klawiszy:

Więcej informacji na temat sterowania aktywnością zawiera opis klasy FocusManager w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional oraz w sekcji Praca z klasą FocusManager .

Dla każdej instancji składnika TextArea można w Inspektorze właściwości lub w Inspektorze składników ustawić następujące parametry tworzenia treści: condenseWhite , editable , hortizontalScrollPolicy , maxChars , restrict , text , verticalScrollPolicy i wordwrap . Dla każdego z tych parametrów istnieje odpowiednia właściwość ActionScript o takiej samej nazwie. Więcej informacji na temat możliwych wartości tych parametrów zawiera opis klasy TextArea w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

Podgląd aktywny każdej instancji TextArea odzwierciedla zmiany dokonane w parametrach w Inspektorze właściwości oraz Inspektorze składników podczas tworzenia. Jeśli wymagany jest pasek przewijania, jest widoczny w podglądzie aktywnym, ale nie działa. W podglądzie aktywnym tekst nie może być zaznaczany i nie można wprowadzać tekstu do instancji składnika na stole montażowym.

Istnieje możliwość napisania kodu ActionScript w celu kontrolowania tych i innych opcji dla składnika TextArea z wykorzystaniem jego właściwości, metod i zdarzeń. Więcej informacji zawiera opis klasy TextArea w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

Poniższa procedura wyjaśnia jak podczas tworzenia dodać składnik TextArea do aplikacji. Przykład przedstawia konfigurację modułu obsługi zdarzeń focusOut w instancji TextArea — ten moduł sprawdza, czy przed aktywacją innej części interfejsu użytkownik wpisał tekst do pola tekstowego.

1. Utwórz nowy dokument Flash (ActionScript 3.0).

2. Przeciągnij składnik TextArea z panelu Składniki na stół montażowy i nadaj nazwę instancji aTa . Pozostaw dla parametrów ustawienia domyślne.

3. Przeciągnij drugi składnik TextArea z panelu Składniki do stołu montażowego, umieść go poniżej pierwszego składnika i nadaj jego instancji nazwę bTa . Pozostaw dla parametrów ustawienia domyślne.

4. Otwórz panel Operacje, zaznacz klatkę nr 1 na głównej osi czasu i wprowadź następujący kod 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(); 
   }

   W tym przykładzie znaki, jakie można wprowadzać do pola tekstowego aTa , zostały ograniczone do małych liter, przecinków, apostrofów i spacji. Przykład konfiguruje również moduły obsługi zdarzeń change , KEY_FOCUS_CHANGE oraz MOUSE_FOCUS_CHANGE w obszarze tekstowym aTa . Funkcja changeHandler() sprawia, że tekst wprowadzony do obszaru tekstowego aTa automatycznie pojawia się w obszarze bTa — dzieje się tak, dlatego że przy każdym zdarzeniu change wartość aTa.text zostaje przypisana do wartości bTa.text . Funkcja k_m_fHandler() dla zdarzeń KEY_FOCUS_CHANGE i MOUSE_FOCUS_CHANGE uniemożliwia naciśnięcie klawisza Tab w celu przejścia do kolejnego pola przed wprowadzeniem tekstu. Funkcja blokuje działanie domyślne.

5. Wybierz polecenie Sterowanie > Testuj film.

   Jeśli klawisz Tab zostanie naciśnięty w celu przejścia do kolejnego obszaru tekstowego przed wprowadzeniem tekstu, powinien pojawić się komunikat o błędzie, a obszar aktywny powinien powrócić do pierwszego obszaru tekstowego. Podczas wprowadzania tekstu do pierwszego obszaru tekstowego ten sam tekst będzie duplikowany w drugim obszarze tekstowym.