Korzystanie ze składnika TextInput

Składnik TextInput może być włączony lub wyłączony w aplikacji. 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 TextInput 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 .

Podgląd aktywny każdej instancji TextInput odzwierciedla zmiany dokonane w parametrach w Inspektorze właściwości oraz Inspektorze składników podczas tworzenia. W podglądzie aktywnym tekst nie może być zaznaczany i nie można wprowadzać tekstu do instancji składnika na stole montażowym.

Po dodaniu składnika TextInput do aplikacji można go udostępnić dla czytnika ekranu, korzystając z panelu Ułatwienia dostępu.

Dla każdej instancji składnika TextInput można w Inspektorze właściwości lub w Inspektorze składników ustawić następujące parametry tworzenia treści: editable , displayAsPassword , maxChars , restrict i text . 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 TextInput w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .

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

Poniższa procedura wyjaśnia jak podczas tworzenia dodać składnik TextInput do aplikacji. W przykładzie wykorzystano dwa pola TextInput w celu wpisania i potwierdzenia hasła. Przykład przedstawia użycie detektora zdarzeń, który wykrywa, czy do każdego z pól zostało wprowadzonych co najmniej osiem znaków oraz czy teksty w każdym z pól są takie same.

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

2. Przeciągnij składnik Label z panelu Składniki na stół montażowy i określ dla niego następujące wartości w Inspektorze właściwości:

   • Wprowadź dla instancji nazwę pwdLabel .

   • Wprowadź wartość dla Sz: 100 .

   • Wprowadź wartość dla X: 50 .

   • Wprowadź wartość dla Y: 150 .

   • W sekcji Parametry wprowadź wartość Hasło: dla parametru tekstu.

3. Przeciągnij drugi składnik Label z panelu Składniki na stół montażowy i określ dla niego następujące wartości:

   • Wprowadź dla instancji nazwę confirmLabel .

   • Wprowadź wartość dla Sz: 100 .

   • Wprowadź wartość dla X: 50 .

   • Wprowadź wartość dla Y: 200 .

   • W sekcji Parametry wprowadź wartość Potwierdźhasło: dla parametru tekstu.

4. Przeciągnij składnik TextInput z panelu Składniki na stół montażowy i określ dla niego następujące wartości:

   • Wprowadź dla instancji nazwę pwdTi .

   • Wprowadź wartość dla Sz: 150 .

   • Wprowadź wartość dla X: 190 .

   • Wprowadź wartość dla Y: 150 .

   • W sekcji Parametry kliknij dwukrotnie wartość dla parametru displayAsPassword i wybierz opcję true . To spowoduje, że wartość wprowadzana do pola tekstowego będzie maskowana gwiazdkami.

5. Przeciągnij drugi składnik TextInput z panelu Składniki na stół montażowy i określ dla niego następujące wartości:

   • Wprowadź dla instancji nazwę confirmTi .

   • Wprowadź wartość dla Sz: 150 .

   • Wprowadź wartość dla X: 190 .

   • Wprowadź wartość dla Y: 200 .

   • W sekcji Parametry kliknij dwukrotnie wartość dla parametru displayA s Password i wybierz opcję true . To spowoduje, że wartość wprowadzana do pola tekstowego będzie maskowana gwiazdkami.

6. Otwórz panel Operacje, zaznacz klatkę nr 1 na głównej osi czasu i wprowadź następujący kod ActionScript:

   function tiListener(evt_obj:Event){ 
   if(confirmTi.text != pwdTi.text || confirmTi.length < 8) 
   { 
           trace("Password is incorrect. Please reenter it."); 
   }  
   else { 
           trace("Your password is: " + confirmTi.text); 
   } 
   } 
   confirmTi.addEventListener("enter", tiListener);

   Ten kod konfiguruje moduł obsługi zdarzeń enter w instancji TextInput o nazwie confirmTi . Jeśli obydwa hasła nie będą takie same lub użytkownik wprowadzi mniej niż osiem znaków, w pojawi się komunikat: „Password is incorrect. Please reenter it”. Jeśli hasła zawierają osiem znaków lub więcej i są zgodne, wprowadzona wartość zostanie wyświetlona w panelu Wyjście.

7. Wybierz polecenie Sterowanie > Testuj film.