Klasa: TextField
Kompatybilność: ActionScript 1.0, Flash 6+
Klasa TextField jest używana do tworzenia obszarów dla tekstów wyświetlanych oraz wejściowych. Wszystkie dynamiczne oraz wejściowe pola tekstowe w pliku SWF są instancjami klasy TextField. Możesz nadać polu tekstowym nazwę instancji, w inspektorze Właściwości oraz użyć metod i właściwości klasy TextField, aby manipulowac go przez ActionScript. Nazwa instancji TextField są wyświetlone w Explorerze Filmu [ Movie Explorer ] oraz w Insert Target Path dialogowym oknie w panelu Actions.
Aby stworzyć pole tekstowe dynamicznie, nie musisz używać operatora new
. Zamiast tego, możesz użyć MovieClip.createTextField()
. Domyślnymi wymiarami dla pola tekstowego są 100 x 100 pikseli.
Metody klasy TextField pozwalają ci na ustawianie, zaznaczanie, oraz manipulowanie tekstu w dynamicznych oraz wejściowych polach tekstowych, które stworzyłeś w GUI lub w ActionScript.
ActionScript dostarcza kilka sposobów do formatowania twojego tekstu podczas trybu pracy. Klasa TextFormat pozwala ci na ustawieniu znaku oraz paragrafu dla obiektów TextField. W Flash Player 7 oraz późniejszych, możesz nadać Kaskadowe Arkusze Styli [Cascading Style Sheets ] (CSS) , do pól tekstowych, używając w tym celu TextField.styleSheet właściwości oraz klasy StyleSheet. Możesz użyć CSS do stylowania wbudowanych tagów HTML, do zdefiniowania nowego formatowania tagów, lub nadania stylów. Możesz dołączyć sformatowany tekst HTML, który może opcjonalnie używać styli CSS, bezpośrednio do pola tekstowego. W Flash Player 7 oraz późniejszych, tekst HTML, który dołączasz do pola tekstowego, może zawierać osadzone media (klipy fimowe, pliki SWF, JPEG, GIF oraz PNG pliki). Tekst zawija się wokół, osadzonej multimedii, w ten sam sposób jak w przeglądarce internetowej robi to HTML dokument.
Flash Player wspomaga, niektóre tagi HTML, które możesz użyc do formatowania tekstu.
Dostępne właściwości dla klasy TextField
Nazwa |
Opis |
---|---|
_alpha |
Ustawia lub odzyskuje wartość kanału alpha przezroczytości pola tekstowego. |
antiAliasType |
Typ wygładzenia dla tej instancji TextField. |
autoSize |
Kontroluje automatyczne powiększanie się oraz wyrównanie dla pola tekstowego. |
background |
Określa czy pole tekstowe posiada wypełnienie tła. |
backgroundColor |
Określa kolor tła dla pola tekstoweg. |
border |
Określa czy pole tekstowe posiada obramowanie. |
borderColor |
Określa kolor obramowania pola tekstowego. |
bottomScroll |
Liczba (bazująca na indeksie 0), określająca dolna linię widoczną dla pola tekstowego. |
condenseWhite |
Wartość logiczna określająca dodatkowe białe znaki (spacje, linie łamiące, itp) w polu tekstoweym HTML, jakie mają być usunięte. |
embedFonts |
Określa, czy użyć do renderowania osadzonej czcionki konturowej. |
filters |
Zindeksowana tablica posiadająca, każdy obiekt filtru, aktualnie nadany na dane pole tekstowe. |
gridFitType |
Typ dopasowanej siatki, użytej dla intancji TextField. |
_height |
Wysokość pola tekstowego, podana w pikselach. |
_highquality |
Wycofywana od Flash Player 7. Ta właściwość jest wycofywana na rzecz Określa poziom wygładzenia nadany na aktualny plik SWF. |
hscroll |
Określa, aktualną poziomową przewijaną pozycję. |
html |
Flaga określająca, czy pole tekstowe reprezentuje kod HTML. |
htmlText |
Jeśli pole tekstowe est HTML polem tekstowym, wtedy ta właściwość zawiera reprezentację znaczników HTML, tego pola tekstowego. |
length |
Określa liczbę znaków w polu tekstowym. |
maxChars |
Określa maksymalną liczbę znaków, która może się pomieścić w polu tekstowym. |
maxhscroll |
Określa maksymalną wartość |
maxscroll |
Określa maksymalna wartość |
menu |
Załącza obiekt ContextMenu z polem tekstowym moj_txt. |
mouseWheelEnabled |
Wartość logiczna określająca, czy Flash Player powinien automatycznie przewijać wielo-liniowe pola tekstowe, kiedy kursor myszy zostanie naciśnięty na polu tekstowych oraz użytkownik zacznie kręcić kółkiem od myszy. |
multiline |
Określa, czy pole tekstowe jest wielo-liniowym polem tekstowym. |
_name |
Nazwa instancji pola tekstowego. |
_parent |
Referencja do klipu filmowego lub obiektu, który zawiera aktualne pole tekstowe lub obiekt. |
password |
Określa, czy pole tekstowe jest pole do wprowadzania hasła użytkownika. |
_quality |
Określa poziom jakość renderowania użytą dla pliku SWF. |
restrict |
Określa zbiór znaków, które użytkownik może wpisać do pola tekstowego. |
_rotation |
Obrót pola tekstowego, podana w stopniach, od jego oryginalnego położenia. |
scroll |
Określa pionową pozycje tekstu w polu tekstowym. |
selectable |
Wartość logiczna, określająca, czy pole tekstowego ma możliwość zaznaczenia jego tekstu przez kursor myszki. |
sharpness |
Określa ostrość krawędzi znaków w instancji TextField. |
_soundbuftime |
Liczba sekund, dźwięku wstępnie załadowanych, przed rozpoczęciem odtwarzania dźwięku strumieniowego. |
styleSheet |
Dołącza arkusz styli do pola tekstowego. |
tabEnabled |
Określa, czy pole tekstowe jest włączone do automatycznego porządku przechodzenia klawiszem TAB. |
tabIndex |
Pozwala ci na dopasowanie porządku TAB obiektów w pliku SWF. |
_target |
Określa ścieżkę docelową do instancji pola tekstoweg. |
text |
Określa aktyalny tekst w polu tekstowym. |
textColor |
Określa kolor tekstu w polu tekstowym. |
textHeight |
Określa wysokość pola tekstowego, podaną w pikselach. |
textWidth |
Określa szerokość pola tekstowego, podaną w pikselach. |
thickness |
Określa grubość krawędzi znaków w tej instancji TextField. |
type |
Określa typ tekstu dla pola tekstowego. |
_url |
Pobiera adres URL pliku SWF, który stworzył dane pole tekstowe. |
variable |
Określa nazwę zmiennej, która jest załączona do tego pola tekstowego. |
_visible |
Wartość logiczna określająca, czy pole tekstowe moj_txt jest widoczne. |
_width |
Określa szerokość pola tekstowego, podaną w pikselach. |
wordWrap |
Wartość logiczna określająca, czy pole tekstowego posiada zawijanie słów. |
_x |
Liczba określająca, zbiór współrzędnych x pola tekstowego, relatywnych do lokalnych współrzędnych, rodzica: klipu filmowego. |
_xmouse |
Zwraca współrzędną x pozycji myszki relatywną do pola tekstowego. |
_xscale |
Określa poziome skalowanie pola tekstowego jak nadany jest punk rejestracji pola tekstowego, wyrażone w procentach. |
_y |
Liczba określająca, zbiór współrzędnych y pola tekstowego, relatywnych do lokalnych współrzędnych, rodzica: klipu filmowego. |
_ymouse |
Zwraca współrzędną y pozycji myszki relatywną do pola tekstowego. |
_yscale |
Określa pionowe skalowanie pola tekstowego jak nadany jest punk rejestracji pola tekstowego, wyrażone w procentach. |
Dostępne zdarzenia dla klasy TextField
Zdarzenie |
Opis |
---|---|
onChanged |
Wywołuje się, gdy zawartość pola tekstowego się zmienia. |
onKillFocus |
Wywołuje się, gdy pole tekstowe traci skupienie klawiatury. |
onScroller |
Wywołuje się, gdy jedno z pól tekstowych zmienia właściwość scroll. |
onSetFocus |
Wywołuje się, gdy pole tekstowe odbiera skupienie klawiatury. |
Dostępne metody dla klasy TextField
Typ |
Nazwa |
Opis |
---|---|---|
|
addListener |
Rejestruje obiekt do odbierania wiadomości zdarzeń dla TextField instancji. |
|
getDepth |
Zwraca głębokość pola tekstowego. |
|
getFontList |
Zwraca nazwy czcionek w odtwarzaczu gospodarza systemu, jako tablicę. |
|
getNewTextFormat |
Zwraca obiekt TextFormat zawierająca kopię pola tekstowego, tekstowego sformatowanego obiektu. |
|
getTextFormat |
Zwraca obiekt TextFormat dla określonego znaku, przedziału znaków, lub cały obiekt TextField. |
|
removeListener |
Usuwa obiekt słuchacza, poprzednio stworzonego przez |
|
removeTextField |
Usuwa pole tekstowe. |
|
replaceSel |
Zastępuje aktualne zaznaczenie z zawartości |
|
replaceText |
Zastępuje przedział znaków, określony przez |
|
setNewTextFormat |
Ustawia domyślny nowy format tekstu dla pola tekstowego. |
|
setTextFormat |
Nadaje tekstowe formatowanie, określone przez |
Listing