Ograniczanie możliwości wprowadzania tekstu

Flash Player 9 i nowsze wersje, Adobe AIR 1.0 i nowsze wersje

Ponieważ pola tekstowe są często używane do realizacji formularzy lub pól dialogowych w aplikacjach, celowe jest niekiedy narzucenie ograniczeń co do typów znaków, jakie użytkownik może wprowadzać w polu tekstowym, a nawet ukrywanie tekstu, np. hasła. Klasa flash.text.TextField zawiera właściwości displayAsPassword i restrict umożliwiające sterowanie wprowadzaniem tekstu przez użytkownika.

Właściwość displayAsPassword ukrywa tekst wpisywany przez użytkownika (wyświetlając go jako szereg gwiazdek). Gdy właściwość displayAsPassword jest ustawiona na true , nie działają polecenia Wytnij i Kopiuj oraz powiązane z nimi skróty klawiaturowe. Jak widać w poniższym przykładzie, wartość właściwości displayAsPassword przypisuje się tak samo, jak wartości innych właściwości, takich jak background i color:

myTextBox.type = TextFieldType.INPUT; 
myTextBox.background = true; 
myTextBox.displayAsPassword = true; 
addChild(myTextBox);

Korzystanie z właściwości restrict jest nieco bardziej skomplikowane, ponieważ konieczne jest określenie znaków dozwolonych do wprowadzania w polu tekstowym. Można zezwolić na wprowadzanie konkretnych liter, cyfr, zakresów liter, cyfr i znaków. W poniższym przykładzie użytkownik może wprowadzać w polu tekstowym tylko wielkie litery (a nie cyfry ani znaki specjalne):

myTextBox.restrict = "A-Z";

W języku ActionScript 3.0 do definiowania zakresów używa się łączników, a do wykluczania konkretnych znaków — symbolu daszka. Więcej informacji na temat definiowania ograniczeń dotyczących pola tekstu wejściowego zawiera opis właściwości flash.text.TextField.restrict w Skorowidzu języka ActionScript 3.0.

Uwaga: Użycie właściwości flash.text.TextField.restrict pozwala automatycznie przekonwertować litery, które nie są dozwolone, na dopuszczalną wielkość. Właściwość fl.text.TLFTextField.restrict (dostępna, gdy jest używane pole tekstowe TLF) powoduje ignorowanie przez środowisko wykonawcze liter, które nie są dozwolone.