Pakiet | flash.text |
Klasa | public class TextField |
Dziedziczenie | TextField InteractiveObject DisplayObject EventDispatcher Object |
Podklasy | FlexTextField |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aby dynamicznie utworzyć pole tekstowe, należy użyć konstruktora TextField()
.
Metody klasy TextField umożliwiają ustawienie, zaznaczenie oraz sterowanie tekstem w polu tekstowym dynamicznym lub wejściowym, które zostało utworzone w trakcie projektowania lub odtwarzania.
Język ActionScript udostępnia kilka sposobów na formatowanie tekstu podczas odtwarzania. Klasa TextFormat umożliwia ustawienie formatowania znaków i akapitu dla obiektu TextField. Za pomocą właściwości TextField.styleSheet
oraz klasy StyleSheet można zastosować style arkusza stylów kaskadowych do pola tekstowego. Za pomocą arkusza CSS można modyfikować wbudowane znaczniki HTML, definiować nowe lub zastosować styl. Sformatowany tekst HTML opcjonalnie korzystający ze stylów CSS można przypisać bezpośrednio do pola tekstowego. Tekst HTML przypisany do pola tekstowego może zawierać osadzone nośniki (klipy filmowe, pliki w formacie SWF, GIF, PNG oraz JPEG). Tekst będzie zawijany wokół osadzonych nośników w taki sam sposób, w jaki przeglądarka zawija tekst wokół nośników osadzonych w dokumencie HTML.
Program Flash Player obsługuje podzbiór znaczników HTML, których można użyć do formatowania tekstu. Lista obsługiwanych znaczników HTML znajduje się w opisie właściwości htmlText
.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Bieżąca implementacja dostępności (AccessibilityImplementation) dla tego wystąpienia klasy InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Bieżące opcje dostępności tego obiektu wyświetlanego. | DisplayObject | ||
alpha : Number
Wartość przezroczystości alfa określonego obiektu. | DisplayObject | ||
alwaysShowSelection : Boolean
Jeśli ma wartość prawda, a pole tekstowe nie jest aktywne, program Flash Player wyróżnia zaznaczenie w polu tekstowym kolorem szarym. | TextField | ||
antiAliasType : String
Typ wygładzania w tym polu tekstowym. | TextField | ||
autoSize : String
Steruje automatycznym wymiarowaniem oraz wyrównywaniem pola tekstowego. | TextField | ||
background : Boolean
Określa, czy pole tekstowe ma wypełnione tło. | TextField | ||
backgroundColor : uint
Kolor tła pola tekstowego. | TextField | ||
blendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć. | DisplayObject | ||
blendShader : Shader [tylko do zapisu]
Ustawia moduł cieniujący, który jest używany do mieszania pierwszego planu oraz tła. | DisplayObject | ||
border : Boolean
Określa, czy pole tekstowe ma obramowanie. | TextField | ||
borderColor : uint
Kolor obramowania pola tekstowego. | TextField | ||
bottomScrollV : int [tylko do odczytu]
Liczba całkowita oznaczająca indeks ostatniego (na samym dole) z wierszy widocznych w polu tekstowym, liczona od 1. | TextField | ||
cacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
W przypadku wartości innej niż null ten obiekt Matrix definiuje sposób renderowania obiektu wyświetlanego, gdy cacheAsBitmap jest ustawione na true. | DisplayObject | ||
caretIndex : int [tylko do odczytu]
Indeks położenia punktu wstawiania (karetki). | TextField | ||
condenseWhite : Boolean
Wartość typu Boolean, która określa czy z pola tekstowego HTML mają być usuwane pewne puste elementy (np. spacje i znaki podziału). | TextField | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
contextMenu : NativeMenu
Określa menu kontekstowe tego obiektu. | InteractiveObject | ||
defaultTextFormat : flash.text:TextFormat
Określa format wstawianego tekstu, np. tekstu wprowadzanego przez użytkownika lub wstawianego za pomocą metody replaceSelectedText(). | TextField | ||
displayAsPassword : Boolean
Wskazuje, czy pole tekstowe jest polem hasła. | TextField | ||
doubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia). | InteractiveObject | ||
embedFonts : Boolean
Określa, czy mają być stosowane osadzone kontury czcionek. | TextField | ||
filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | DisplayObject | ||
focusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności. | InteractiveObject | ||
gridFitType : String
Typ dopasowywania do siatki w tym polu tekstowym. | TextField | ||
height : Number
Wysokość obiektu ekranowego w pikselach. | DisplayObject | ||
htmlText : String
Zawiera reprezentację zawartości pola tekstowego w formacie HTML. | TextField | ||
length : int [tylko do odczytu]
Liczba znaków w polu tekstowym. | TextField | ||
loaderInfo : LoaderInfo [tylko do odczytu]
Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany. | DisplayObject | ||
mask : DisplayObject
Wywoływany obiekt wyświetlany jest maskowany przez określony obiekt maski. | DisplayObject | ||
maxChars : int
Maksymalna liczba znaków, które użytkownik może wprowadzić w polu tekstowym. | TextField | ||
maxScrollH : int [tylko do odczytu]
Maksymalna wartość scrollH. | TextField | ||
maxScrollV : int [tylko do odczytu]
Maksymalny zakres scrollV | TextField | ||
metaData : Object
Pobiera obiekt metadanych wystąpienia klasy DisplayObject, jeśli metadane są przechowywane razem z tym wystąpieniem klasy DisplayObject w pliku SWF, korzystając ze znacznika PlaceObject4. | DisplayObject | ||
mouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. | InteractiveObject | ||
mouseWheelEnabled : Boolean
Wartość typu Boolean określająca, czy program Flash Player powinien automatycznie przewijać wielowierszowe pole tekstowe, gdy użytkownik kliknie na nie i poruszy pokrętłem myszy. | TextField | ||
mouseX : Number [tylko do odczytu]
Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | ||
mouseY : Number [tylko do odczytu]
Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | ||
multiline : Boolean
Określa, czy pole tekstowe jest polem wielowierszowym. | TextField | ||
name : String
Nazwa instancji obiektu DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Określa, czy klawiatura wirtualna (klawiatura programowa wyświetlana na ekranie) powinna być wyświetlana, gdy to wystąpienie klasy InteractiveObject staje się aktywne. | InteractiveObject | ||
numLines : int [tylko do odczytu]
Określa liczbę wierszy w wielowierszowym polu tekstowym. | TextField | ||
opaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty. | DisplayObject | ||
parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | DisplayObject | ||
restrict : String
Oznacza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym. | TextField | ||
root : DisplayObject [tylko do odczytu]
Dla obiektu wyświetlanego w załadowanym pliku SWF główną właściwość stanowi obiekt wyświetlany na samym szczycie na liście wyświetlania w postaci struktury drzewa, którą reprezentuje plik SWF. | DisplayObject | ||
rotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach). | DisplayObject | ||
rotationX : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi x — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rotationY : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi y — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rotationZ : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi z — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
scale9Grid : Rectangle
Aktualnie stosowana siatka skalowania. | DisplayObject | ||
scaleX : Number
Wskazuje skalę poziomą (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scaleY : Number
Wskazuje skalę pionową (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scaleZ : Number
Wskazuje skalę głębokości (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scrollH : int
Bieżące położenie podczas przewijania poziomego. | TextField | ||
scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | DisplayObject | ||
scrollV : int
Pionowe położenie tekstu w polu tekstowym. | TextField | ||
selectable : Boolean
Wartość typu Boolean wskazująca, czy dane pole tekstowe można zaznaczać. | TextField | ||
selectionBeginIndex : int [tylko do odczytu]
Indeks pierwszego znaku w bieżącym zaznaczeniu, liczony od 0. | TextField | ||
selectionEndIndex : int [tylko do odczytu]
Indeks ostatniego znaku w bieżącym zaznaczeniu, liczony od 0. | TextField | ||
sharpness : Number
Ostrość krawędzi glifów w polu tekstowym. | TextField | ||
softKeyboard : String
Steruje wyglądem klawiatury programowej. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definiuje obszar, który powinien pozostać na ekranie po wyświetleniu klawiatury programowej (niedostępna w systemie iOS). | InteractiveObject | ||
stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | DisplayObject | ||
styleSheet : StyleSheet
Dołącza do pola tekstowego arkusz stylu. | TextField | ||
tabEnabled : Boolean
Określa, czy do tego obiektu można przejść za pomocą klawisza Tab. | InteractiveObject | ||
tabIndex : int
Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. | InteractiveObject | ||
text : String
Ciąg znaków odpowiadający bieżącemu tekstowi w polu tekstowym. | TextField | ||
textColor : uint
Kolor tekstu w polu tekstowym (w formacie szesnastkowym). | TextField | ||
textHeight : Number [tylko do odczytu]
Wysokość tekstu w pikselach. | TextField | ||
textInteractionMode : String [tylko do odczytu]
Właściwość trybu interakcji, której wartością domyślną jest TextInteractionMode.NORMAL. | TextField | ||
textWidth : Number [tylko do odczytu]
Szerokość tekstu w pikselach. | TextField | ||
thickness : Number
Grubość krawędzi glifów w polu tekstowym. | TextField | ||
transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | DisplayObject | ||
type : String
Typ pola tekstowego. | TextField | ||
useRichTextClipboard : Boolean
Określa, czy razem z tekstem można kopiować i wklejać jego format. | TextField | ||
visible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie. | DisplayObject | ||
width : Number
Szerokość obiektu ekranowego w pikselach. | DisplayObject | ||
wordWrap : Boolean
Wartość typu Boolean wskazująca, że tekst w polu tekstowym może być zawijany. | TextField | ||
x : Number
Oznacza współrzędną x instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | DisplayObject | ||
y : Number
Oznacza współrzędną y instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | DisplayObject | ||
z : Number
Wskazuje współrzędną wzdłuż osi Z instancji DisplayObject względem nadrzędnego kontenera 3D. | DisplayObject |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Tworzy nową instancję klasy TextField. | TextField | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | ||
Dołącza ciąg wskazany w parametrze newText na końcu tekstu w polu tekstowym. | TextField | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace). | DisplayObject | ||
Zwraca prostokąt będący obwiednią znaku. | TextField | ||
Zwraca indeks znaku (liczony od 0) w punkcie określonym za pomocą parametrów x i y. | TextField | ||
Po otrzymaniu indeksu znaku zwraca indeks pierwszego znaku w tym samym akapicie. | TextField | ||
Zwraca odwołanie do obiektu DisplayObject o podanym identyfikatorze. Operacja dotyczy obrazu lub pliku SWF, które dodano do sformatowanego pola tekstowego HTML za pomóc znacznika <img>. | TextField | ||
Zwraca indeks (liczony od 0) wiersza określonego za pomocą parametrów x i y. | TextField | ||
Zwraca liczony od 0 indeks wiersza zawierającego znak określony przez parametr charIndex. | TextField | ||
Zwraca liczbę znaków w określonym wierszu tekstowym. | TextField | ||
Zwraca informacje o wymiarach danego wiersza tekstu. | TextField | ||
Zwraca indeks pierwszego znaku w wierszu określonego przez parametr lineIndex. | TextField | ||
Zwraca wiersz tekstowy określony przez parametr lineIndex. | TextField | ||
Po podaniu indeksu znaku zwraca wartość długości akapitu zawierający dany znak. | TextField | ||
Zwraca prostokąt definiujący granice obiektu wyświetlanego w układzie współrzędnych określonych przez parametr targetCoordinateSpace (z wyłączeniem konturów kształtów). | DisplayObject | ||
Zwraca obiekt TextFormat, który zawiera informacje o formatowaniu dla zakresu tekstu określonego przez parametry beginIndex i endIndex. | TextField | ||
Konwertuje obiekt punktowy ze współrzędnych obiektu Stage (globalne) do współrzędnych obiektu wyświetlanego (lokalne). | DisplayObject | ||
Konwertuje punkt dwuwymiarowy ze współrzędnych stołu wymiarowego (globalnych) na współrzędne trójwymiarowego obiektu wyświetlanego (lokalne). | DisplayObject | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wyznacza prostokąt ograniczający obiekt wyświetlany w celu sprawdzenia, czy zachodzi on lub przecina się z prostokątem ograniczającym obiektu wyświetlanego obj. | DisplayObject | ||
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y. | DisplayObject | ||
[statyczny]
Zwraca wartość, jeśli osadzona czcionka jest dostępna z określonymi parametrami fontName i fontStyle, gdzie Font.fontType ma wartość flash.text.FontType.EMBEDDED. | TextField | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Konwertuje punkt trójwymiarowy trójwymiarowego obiektu wyświetlanego (lokalnego) na punkt dwuwymiarowy we współrzędnych stołu montażowego (globalnych). | DisplayObject | ||
Konwertuje obiekt punktowy ze współrzędnych obiektu wyświetlanego (lokalne) do współrzędnych obiektu Stage (globalne). | DisplayObject | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Zastępuje bieżące zaznaczenie zawartością określoną przez parametr wartości. | TextField | ||
Zastępuje zakres znaków określony przez parametry beginIndex i endIndex zawartością parametru newText. | TextField | ||
Powoduje uniesienie klawiatury wirtualnej. | InteractiveObject | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zaznacza tekst określony wartościami indeksu pierwszego i ostatniego znaku, podanymi w parametrach beginIndex oraz endIndex. | TextField | ||
Stosuje formatowanie tekstowe określone przez parametr formatowania do danego tekstu w polu tekstowym. | TextField | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
---|---|---|---|---|
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | |||
Wywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania. | DisplayObject | |||
Wywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania na scenie — albo bezpośrednio, albo wskutek dodania poddrzewa zawierającego obiekt wyświetlany. | DisplayObject | |||
Wywoływane po zmodyfikowaniu wartości kontrolnej — inaczej niż zdarzenie textInput, które jest wywoływane przed modyfikacją wartości. | TextField | |||
Wywoływane, gdy użytkownik wybierz opcje „Wyczyść” (lub „Usuń”) z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane w momencie naciśnięcia i zwolnienia głównego przycisku urządzenia wskazującego przez użytkownika na tej samej instancji InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy w wyniku gestu użytkownika zostanie uaktywnione menu kontekstowe skojarzone z tym obiektem interaktywnym w aplikacji AIR. | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację kopiowania lub wybiera polecenie Kopiuj z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wycięcia lub wybiera polecenie Wytnij z menu kontekstowego dla tekstu. | InteractiveObject | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Wywoływane w momencie, gdy użytkownik naciska i zwalnia główny przycisk urządzenia wskazującego dwukrotnie w krótkim odstępie czasu nad tym samym obiektem InteractiveObject, podczas gdy flaga doubleClickEnabled obiektu jest ustawiona na wartość true. | InteractiveObject | |||
[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania przechodzi do nowej klatki. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania kończy odtwarzanie bieżącej klatki. | DisplayObject | |||
Wywoływane po uaktywnieniu obiektu wyświetlanego. | InteractiveObject | |||
Dysponowana, gdy obiekt ekranowy przestaje być aktywny. | InteractiveObject | |||
[zdarzenie broadcast] Wywoływane po zadziałaniu konstruktorów obiektów wyświetlanych klatek, ale przed działaniem skryptów klatek. | DisplayObject | |||
Zostaje rozesłane, gdy użytkownik utworzy punkt styku wzdłuż krawędzi powierzchni dotykowej z instancją obiektu InteractiveObject (np. dotknięcie wzdłuż krawędzi powierzchni dotykowej pilota Siri Remote do telewizora firmy Apple). Niektóre urządzenia mogą również interpretować taki styk, jako kombinację różnych zdarzeń dotykowych. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie na dwa punkty kontaktu nad tą samą instancją klasy InteractiveObject na urządzeniu dotykowym (np. naciśnie dwoma palcami i zwolni obiekt wyświetlany na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa punkt kontaktu nad wystąpieniem klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przesuwanie palców z lewej strony na prawą nad obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest obrotu w punkcie kontaktu z instancją klasy InteractiveObject (np. dotknie obiektu wyświetlanego dwoma palcami i obróci palce na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest machnięcia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie trzema złączonymi palcami ekranu, a następnie szybkie przesunięcie ich nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik utworzy punkt kontaktu z instancją obiektu InteractiveObject, a następnie stuknie w urządzenie dotykowe (np. przyłoży kilka palców do obiektu wyświetlanego w celu otwarcia menu, a następnie stuknie jednym palcem, aby wybrać element menu na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest powiększenia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie dwoma palcami ekranu, a następnie szybkie rozsunięcie palców nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
To zdarzenie jest wywoływane w każdej aplikacji klienckiej, która obsługuje lokalne wprowadzanie znaków za pomocą edytora IME. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie klawisz. | InteractiveObject | |||
Dysponowana, gdy użytkownik próbuje uaktywnić inny element za pomocą klawiatury. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni klawisz. | InteractiveObject | |||
Wywoływane, gdy użytkownik klika hiperłącze w polu tekstowym HTML, którego adres URL zaczyna się od ciągu „event:”. | TextField | |||
Wywoływane, gdy użytkownik naciśnie i zwolni środkowy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie środkowy przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik próbuje uaktywnić inny element za pomocą urządzenia wskazującego. | InteractiveObject | |||
Dysponowana, gdy użytkownik ustawi kursor nad instancją obiektu InteractiveObject i poruszy urządzenie wskazujące. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor poza instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Dysponowana, gdy użytkownik przesunie kursor nad instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy kółko myszy zostanie obrócone nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane przez obiekt InteractiveObject inicjujący przeciąganie, gdy użytkownik zwolni przycisk podczas przeciągania. | InteractiveObject | |||
Wywoływane przez docelowy obiekt InteractiveObject, gdy przeciągany obiekt zostanie na niego upuszczony i upuszczenie zostanie zaakceptowane wywołaniem DragManager.acceptDragDrop(). | InteractiveObject | |||
Wywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik wchodzi w granice tego obiektu. | InteractiveObject | |||
Wywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik opuści granice tego obiektu. | InteractiveObject | |||
Regularnie wywoływane przez obiekt InteractiveObject, gdy wskaźnik podczas przeciągania pozostaje w granicach tego obiektu. | InteractiveObject | |||
Wywoływane na początku operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag(). | InteractiveObject | |||
Wywoływane podczas operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag(). | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wklejenia lub wybiera polecenie Wklej z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane, gdy użytkownik opuści aktywny pisak na odległość mniejszą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik uniesie aktywny pisak na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak nad ekranem, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak poza dany obiekt InteractiveObject, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak bezpośrednio nad danym obiektem InteractiveObject, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak poza obiekt InteractiveObject i jego obiekty potomne, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak z obszaru poza drzewem obiektów potomnych danego obiektu InteractiveObject na liście wyświetlania nad ten obiekt (przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna wartość wykrywania dla ekranu). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwalnia przycisk urządzenia wskazującego, jeśli wcześniej nacisnął ten przycisk na wystąpieniu klasy InteractiveObject i przesunął wskaźnik urządzenia poza to wystąpienie klasy InteractiveObject. | InteractiveObject | |||
Dysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania. | DisplayObject | |||
Dysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania na scenie — albo bezpośrednio, albo wskutek usunięcia poddrzewa zawierającego obiekt ekranowy. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane, gdy lista wyświetlania ma być aktualizowana lub renderowana. | DisplayObject | |||
Wywoływane, gdy użytkownik naciśnie i zwolni prawy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor poza wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor nad wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane przez obiekt TextField, gdy użytkownik przewinął tekst. | TextField | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację zaznaczenia wszystkiego lub wybiera polecenie „Zaznacz wszystko” z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane bezpośrednio po uniesieniu klawiatury programowej. | InteractiveObject | |||
Wywoływane bezpośrednio przed uniesieniem klawiatury programowej. | InteractiveObject | |||
Wywoływane bezpośrednio po opuszczeniu klawiatury programowej. | InteractiveObject | |||
Wywoływane, gdy zmienia się wartość flagi tabChildren obiektu. | InteractiveObject | |||
Wywoływane, gdy zmienia się flaga tabEnabled obiektu. | InteractiveObject | |||
Wywoływane, gdy zmienia się wartość właściwości tabIndex obiektu. | InteractiveObject | |||
Program Flash Player wywołuje zdarzenie textInput, kiedy użytkownik wprowadzi co najmniej jeden znak. | TextField | |||
Program Flash Player wywołuje zdarzenie textInteractionModeChange, gdy użytkownik zmienia tryb interakcji pola tekstowego. | TextField | |||
Wywoływane, gdy użytkownik zainicjuje kontakt z urządzeniem dotykowym (np. dotknie palcem ekranu dotykowego telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przerwie kontakt z urządzeniem dotykowym (np. uniesie palec z ekranu dotykowego telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik dotyka urządzenia. Wywołanie jest powtarzane w sposób ciągły do momentu usunięcia punktu kontaktu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu od instancji klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z jednego obiektu wyświetlanego do punktu na drugim obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu nad instancję klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z punktu poza obiektem wyświetlanym do punktu na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa punkt kontaktu poza wystąpienie klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przeciągnięcie palcem znad obiektu ekranowego do punktu poza obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym). | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu nad instancję klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z punktu poza obiektem wyświetlanym do punktu na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni nacisk na ekran dotykowy w punkcie kontaktu na tej samej instancji klasy InteractiveObject, na której kontakt został zainicjowany (na przykład naciśnie palcem i zwolni pojedynczy punkt na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject |
alwaysShowSelection | właściwość |
alwaysShowSelection:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Jeśli ma wartość true
, a pole tekstowe nie ma fokusu, program Flash Player wyróżnia zaznaczenie w polu tekstowym kolorem szarym. Jeśli ma wartość false
, a pole tekstowe jest aktywne, program Flash Player nie wyróżnia zaznaczenia w polu tekstowym kolorem szarym.
Wartością domyślną jest false.
Implementacja
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_alwaysShowSelection extends Sprite { public function TextField_alwaysShowSelection() { var label1:TextField = createCustomTextField(0, 20, 200, 20); label1.text = "This text is selected."; label1.setSelection(0, 9); label1.alwaysShowSelection = true; var label2:TextField = createCustomTextField(0, 50, 200, 20); label2.text = "Drag to select some of this text."; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
antiAliasType | właściwość |
antiAliasType:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Typ wygładzania w tym polu tekstowym. Dal tej właściwości użyj wartości stałych flash.text.AntiAliasType
. Tym ustawieniem można sterować tylko w przypadku, gdy czcionka została osadzona (właściwość embedFonts
ustawiona na wartość true
). Ustawienie domyślne to flash.text.AntiAliasType.NORMAL
.
W celu ustawienia wartości tej właściwości należy użyć następujących wartości ciągu znaków:
Wartość ciągu znaków | Opis |
---|---|
flash.text.AntiAliasType.NORMAL | Stosuje zwykłe wygładzanie tekstu. Ta wartość odpowiada typowi wygładzania dostępnego w programie Flash Player 7 i starszych wersjach. |
flash.text.AntiAliasType.ADVANCED | Stosuje zaawansowane wygładzanie tekstu, dzięki któremu tekst jest bardziej czytelny. (Ta opcja została udostępniona w programie Flash Player 8). Zaawansowane wygładzanie umożliwia renderowanie czcionek wysokiej jakości nawet przy ich niewielkich rozmiarach. Zaleca się stosowanie tej funkcji w przypadku aplikacji, które zawierają dużo tekstu o małym rozmiarze czcionki. Nie zaleca się stosowania zaawansowanego wygładzania w przypadku czcionek o wielkości większej niż 48 punktów. |
Implementacja
public function get antiAliasType():String
public function set antiAliasType(value:String):void
Powiązane elementy interfejsu API
autoSize | właściwość |
autoSize:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Steruje automatycznym wymiarowaniem oraz wyrównywaniem (do prawej, lewej) pola tekstowego. Dopuszczalne wartości dla stałych TextFieldAutoSize
: TextFieldAutoSize.NONE
(domyślna), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
oraz TextFieldAutoSize.CENTER
.
Ustawianie właściwości autoSize
na wartość TextFieldAutoSize.NONE
(domyślna) nie powoduje zmiany rozmiaru.
Ustawienie właściwości autoSize
na wartość TextFieldAutoSize.LEFT
spowoduje, że tekst zostanie potraktowany jak tekst wyrównany do lewej, co oznacza, że lewy margines tekstu w polu tekstowym pozostaje bez zmiany, a jakakolwiek zmiana rozmiaru pojedynczego wiersza pola tekstowego wpływa na prawy margines. Jeśli tekst zawiera znak podziału (na przykład, "\n"
lub "\r"
), rozmiar dolnej krawędzi również zostaje zmieniony celem dopasowania do następnego wiersza tekstowego. Ustawienie właściwości wordWrap
na wartość true
spowoduje, że tylko rozmiar dolnej krawędzi pola tekstowego ulegnie zmianie, a prawa strona pozostanie stała.
Ustawienie właściwości autoSize
na wartość TextFieldAutoSize.RIGHT
spowoduje, że tekst zostanie potraktowany jako tekst wyrównany do prawej, co oznacza, że prawy margines pola tekstowego pozostaje stały, a jakakolwiek zmiana rozmiaru pojedynczego wiersza tekstowego wpływa na lewy margines. Jeśli tekst zawiera znak podziału (na przykład, "\n" lub "\r")
, rozmiar dolnej krawędzi ulegnie zmianie celem dopasowania do następnego wiersza tekstowego. Ustawienie właściwości wordWrap
na wartość true
spowoduje, że rozmiar tylko dolnej krawędzi pola tekstowego ulegnie zmianie, a lewa jego strona pozostanie bez zmian.
Ustawienie właściwości autoSize
na wartość TextFieldAutoSize.CENTER
spowoduje, że tekst zostanie potraktowany jak tekst wyrównany do środka, co oznacza, że jakakolwiek zmiana wielkości pojedynczego wiersza w polu tekstowym spowoduje jego równe rozłożenie między prawym i lewym marginesem. Jeśli tekst zawiera znak podziału (na przykład, "\n"
lub "\r"
), rozmiar dolnej krawędzi również zostaje zmieniony celem dopasowania do następnego wiersza tekstu. Ustawienie właściwości wordWrap
również na wartość true
spowoduje, że wielkość dolnej krawędzi pola tekstowego ulegnie zmianie, a prawa i lewa strona pozostanie bez zmian.
Implementacja
public function get autoSize():String
public function set autoSize(value:String):void
Zgłasza
ArgumentError — Określona właściwość autoSize nie należy do obiektu flash.text.TextFieldAutoSize.
|
Powiązane elementy interfejsu API
background | właściwość |
background:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy pole tekstowe ma wypełnione tło. Wartość true
oznacza, że tło pola tekstowego zawiera wypełnienie. Wartość false
oznacza, że tło pola tekstowego nie zawiera wypełnienia. Właściwość backgroundColor
służy do ustawienia koloru tła pola tekstowego.
Wartością domyślną jest false.
Implementacja
public function get background():Boolean
public function set background(value:Boolean):void
Powiązane elementy interfejsu API
backgroundColor | właściwość |
backgroundColor:uint
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kolor tła pola tekstowego. Wartość domyślna to 0xFFFFFF
(biały). Tę właściwość można pobrać lub ustawić, nawet w przypadku braku tła w danym momencie. Jednakże kolor będzie widoczny tylko wówczas, gdy właściwość background
pola tekstowego zostanie ustawiona na wartośćtrue
.
Implementacja
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
Powiązane elementy interfejsu API
border | właściwość |
border:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy pole tekstowe ma obramowanie. Wartość true
oznacza, że pole tekstowe ma obramowanie. Wartość false
oznacza, że pole tekstowe nie ma obramowania. Właściwość borderColor
umożliwia ustawienie koloru obramowania.
Wartością domyślną jest false.
Implementacja
public function get border():Boolean
public function set border(value:Boolean):void
Powiązane elementy interfejsu API
borderColor | właściwość |
borderColor:uint
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kolor obramowania pola tekstowego. Wartość domyślna to 0x000000
(czarny). Tę właściwość można pobrać lub ustawić, nawet w przypadku braku obramowania w danym momencie. Jednakże kolor będzie widoczny tylko wówczas, gdy właściwość border
pola tekstowego zostanie ustawiona na wartość true
.
Implementacja
public function get borderColor():uint
public function set borderColor(value:uint):void
Powiązane elementy interfejsu API
bottomScrollV | właściwość |
bottomScrollV:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liczba całkowita oznaczająca indeks ostatniego (na samym dole) z wierszy widocznych w polu tekstowym, liczona od 1. Pole tekstowe można traktować jak okno na fragment tekstu. Właściwość scrollV
to indeks (którego zbiór wartości zaczyna się liczbą 1) pierwszego widocznego wiersza znajdującego się górnej części okna,
Cały tekst, który znajduje się między wierszami określonymi za pomocą właściwości scrollV
i bottomScrollV
jest aktualnie widoczny w polu tekstowym.
Implementacja
public function get bottomScrollV():int
Powiązane elementy interfejsu API
caretIndex | właściwość |
caretIndex:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indeks położenia punktu wstawiania (karetki). Jeśli punkt wstawiania nie jest wyświetlany, wartość określa położenie punktu wstawiania, które zaistniałoby w przypadku przywrócenia polu aktywności (zwykle ostatnie położenie punktu wstawiania lub wartość 0, jeśli pole nie było aktywne).
Wartości dla indeksów zakresu zaznaczenia zaczynają się od wartości 0 (na przykład wartości pierwszej pozycji to 0, drugiej to 1, itd.).
Implementacja
public function get caretIndex():int
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
printCursorPosition
w momencie kliknięcia pola tekstowego TextField. W takim przypadku wartości wynikowe właściwości caretIndex
, selectionBeginIndex
oraz selectionEndIndex
stanowią wartości wyjściowe.
Należy wykonać czynności przedstawione w przykładzie i spróbować kliknąć obszar w polu tekstowym w celu zaznaczenia tekstu. Następnie należy kliknąć pole, nie zaznaczając tekstu. Podczas klikania tekstu bez zaznaczenia właściwość caretIndex
wskazuje punkt wstawiania, a właściwości selectionBeginIndex
oraz selectionEndIndex
są równe wartości właściwości caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
condenseWhite | właściwość |
condenseWhite:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość typu Boolean, która określa czy z pola tekstowego HTML mają być usuwane pewne puste elementy (np. spacje i znaki podziału). Wartością domyślną jest false
. Właściwość condenseWhite
dotyczy tylko tekstu z ustawieniem właściwości htmlText
, a nie właściwości text
. Użycie tekstu z właściwością text
spowoduje zignorowanie właściwości condenseWhite
.
Jeśli dla właściwości condenseWhite
ustawiona jest wartość true
, w celu umieszczenia odstępów w polu tekstowym należy użyć standardowych poleceń HTML, takich jak <BR>
i <P>
.
Zanim właściwość htmlText
zostanie ustawiona należy ustawić właściwość condenseWhite
.
Implementacja
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
condenseWhite
na wartość false
, a następnie na wartość true
:
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_condenseWhite extends Sprite { public function TextField_condenseWhite() { var tf1:TextField = createCustomTextField(0, 0, 200, 50); tf1.condenseWhite = false; tf1.htmlText = "keep on\n\ttruckin'"; var tf2:TextField = createCustomTextField(0, 120, 200, 50); tf2.condenseWhite = true; tf2.htmlText = "keep on\n\ttruckin'"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; addChild(result); return result; } } }
defaultTextFormat | właściwość |
defaultTextFormat:flash.text:TextFormat
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa format wstawianego tekstu, np. tekstu wprowadzanego przez użytkownika lub wstawianego za pomocą metody replaceSelectedText()
.
Uwaga: W przypadku zaznaczania znaków do zastąpienia przy użyciu metod setSelection()
i replaceSelectedText()
format defaultTextFormat
zostanie zastosowany wyłącznie wtedy, gdy tekst został zaznaczony do ostatniego znaku włącznie. Oto przykład:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
Podczas korzystania z właściwości defaultTextFormat
, wszystkie wartości w zwróconym obiekcie TextFormat są zdefiniowane. Żadna z właściwości nie ma wartości null
Uwaga: Nie można ustawić tej właściwości, jeśli do pola tekstowego zastosowano arkusz stylów.
Implementacja
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
Zgłasza
Error — Tej metody nie można stosować dla pola tekstowego zawierającego arkusz stylów.
|
Powiązane elementy interfejsu API
displayAsPassword | właściwość |
displayAsPassword:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wskazuje, czy pole tekstowe jest polem hasła. Wartość true
tej właściwości oznacza, że pole tekstowe jest traktowane jak pole hasła i ukrywa wpisywane znaki, wyświetlając w ich miejscu znaki gwiazdki. Wartość false
oznacza, że pole tekstowe nie jest traktowane jak pole hasła. Włączony tryb hasła uniemożliwia korzystanie z poleceń Wytnij i Kopiuj, a odpowiadające im skróty klawiaturowe nie będą aktywne. Ten mechanizm zabezpieczający uniemożliwia nieuprawnionemu użytkownikowi korzystanie ze skrótów w celu odkrycia hasła do komputera pozostawionego bez nadzoru.
Wartością domyślną jest false.
Implementacja
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
embedFonts | właściwość |
embedFonts:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy mają być stosowane osadzone kontury czcionek. Jeśli wartością jest false
, program Flash Player renderuje pole tekstowe za pomocą czcionek urządzenia.
Ustawienie właściwości embedFonts
dla pola tekstowego na wartość true
wymaga określenia czcionki dla tego tekstu za pomocą właściwości font
obiektu TextFormat, który został zastosowany do pola tekstowego. Jeśli określona czcionka nie jest osadzona w pliku SWF, tekst nie jest wyświetlany.
Wartością domyślną jest false.
Implementacja
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
Powiązane elementy interfejsu API
gridFitType | właściwość |
gridFitType:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Typ dopasowywania do siatki w tym polu tekstowym. Ta właściwość ma zastosowanie tylko w przypadku, gdy właściwość flash.text.AntiAliasType
pola tekstowego jest ustawiona na wartość flash.text.AntiAliasType.ADVANCED
.
Zastosowany typ dopasowania siatki określa, czy w programie Flash Player główne pionowe i poziome linie siatki mają zostać dopasowane do siatki subpikseli.
Dla właściwości flash.text.GridFitType
dostępne są następujące wartości ciągów znaków:
Wartość ciągu znaków | Opis |
---|---|
flash.text.GridFitType.NONE | Określa brak dopasowania siatki. Linie poziome i pionowe w glifach nie są przyciągane do siatki pikselowej. To ustawienie jest zalecane w przypadku animacji lub tekstu o dużym rozmiarze czcionki. |
flash.text.GridFitType.PIXEL | Określa dopasowanie poziomych i pionowych głównych linii siatki do siatki pikseli. To ustawienie sprawdza się tylko dla pól tekstowych o wyrównaniu do lewej. Korzystanie z tej właściwości wymaga ustawienia właściwości flash.dispaly.AntiAliasType pola tekstowego na wartość flash.text.AntiAliasType.ADVANCED . To ustawienie udostępnia najlepszą czytelność dla tekstu wyrównanego do lewej. |
flash.text.GridFitType.SUBPIXEL | Określa dopasowanie poziomych i pionowych głównych linii siatki do siatki subpikseli w monitorach LCD. Korzystanie z tego ustawienia wymaga ustawienia właściwości flash.text.AntiAliasType pola tekstowego na wartość flash.text.AntiAliasType.ADVANCED . Ustawienie flash.text.GridFitType.SUBPIXEL często sprawdza się dla dynamicznego tekstu wyrównanego do prawej lub do środka jak również w przypadku, gdy jakość tekstu jest ważniejsza od jakości animacji. |
Wartością domyślną jest pixel.
Implementacja
public function get gridFitType():String
public function set gridFitType(value:String):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
gridFitType
. W przypadku korzystania z tego przykładu należy zwrócić uwagę na czytelność pierwszych dwu wierszy. Należy również zwrócić uwagę na optymalne wykorzystanie właściwości GridFitType.PIXEL
w przypadku tekstu wyrównywanego do lewej oraz GridFitType.SUBPIXEL
w przypadku tekstu wyrównywanego do prawej.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; public class gridFitTypeExample extends Sprite { public function gridFitTypeExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=12; var tf1:TextField = createCustomTextField(0,0,format1,"NONE",TextFieldAutoSize.LEFT,GridFitType.NONE); var tf2:TextField = createCustomTextField(0,30,format1,"PIXEL",TextFieldAutoSize.LEFT,GridFitType.PIXEL); var tf3:TextField = createCustomTextField(300,60,format1,"SUBPIXEL",TextFieldAutoSize.RIGHT,GridFitType.SUBPIXEL); } private function createCustomTextField(x:Number,y:Number,fm:TextFormat,tl:String,tfs:String,gft:String):TextField { var result:TextField = new TextField(); result.x=x; result.y=y; result.embedFonts=true; result.antiAliasType=AntiAliasType.ADVANCED; result.text="This text uses a gridFitType of " + tl; result.autoSize=tfs; result.gridFitType=gft; result.setTextFormat(fm); addChild(result); return result; } } }
htmlText | właściwość |
htmlText:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zawiera reprezentację zawartości pola tekstowego w formacie HTML.
Program Flash Player obsługuje następujące znaczniki HTML:
Znacznik | Opis |
---|---|
Znacznik zakotwiczenia |
Znacznik <a> służy do tworzenia łącza hipertekstowego i obsługuje następujące atrybuty:
|
Znacznik pogrubienia |
Znacznik <b> renderuje tekst jako pogrubiony. Użyta czcionka musi być dostępna w typie pogrubiona.
|
Znacznik podziału |
Znacznik podziału <br> wstawia znak podziału między wierszami w polu tekstowym. Ten znacznik powoduje, że pole tekstowe staje się wielowierszowe.
|
Znacznik czcionki |
Znacznik czcionki <font> określa czcionkę lub listę czcionek wyświetlanego tekstu. Znacznik czcionek obsługuje następujące atrybuty:
|
Znacznik obrazu |
Znacznik <img> umożliwia osadzenie zewnętrznych plików obrazu (JPEG, GIF, PNG), plików SWF oraz klipów filmowych wewnątrz pól tekstowych. Tekst samoczynnie układa się wokół obrazów osadzonych w polach tekstowych. W celu zawijania tekstu wokół obrazu należy ustawić pole tekstowe jako wielowierszowe.
Znacznik
Program Flash wyświetla w pełnym wymiarze nośniki osadzone w polu tekstowym. Aby zdefiniować wymiary osadzanego nośnika, należy użyć atrybutów znacznika Zwykle, obraz osadzony w polu tekstowym pojawia się w wierszu następującym po znaczniku Dla treści aplikacji AIR w obszarze izolowanym aplikacji środowisko AIR ignoruje znaczniki |
Znacznik kursywy |
Znacznik kursywy <i> wyświetla oznaczony tekst w kursywie. Użyta czcionka musi być dostępna w typie kursywa.
|
Znacznik elementu listy |
Znacznik elementu listy <li> powoduje umieszczenie punktora na początku poprzedzanego tekstu. Uwaga: Ponieważ program Flash Player oraz środowisko AIR nie rozróżnia list uporządkowanych i nieuporządkowanych (<ol> i <ul> ), typy znaczników nie wpływają na sposób renderowania tekstu. Wszystkie listy są nieuporządkowane, a wszystkie pozycje listy poprzedzone są punktorami.
|
Znacznik akapitu |
Znacznik paragrafu <p> umożliwia utworzenie nowego akapitu. Tego znacznika można używać w polu tekstowym ustawionym na jako wielowierszowe. Znacznik <p> obsługuje następujące atrybuty:
|
Znacznik zakresu |
Znacznika zakresu <span> można używać tylko w połączeniu ze stylami tekstu CSS. Znacznik obsługuje następujący atrybut:
|
Znacznik formatu tekstu |
Znacznik formatu tekstu Znacznik
|
Znacznik podkreślenia |
Znacznik podkreślenia <u> Ustawia podkreślenie dla tekstu oznaczonego tym znacznikiem.
|
Program Flash Player i środowisko AIR obsługują następujące elementy HTML:
Element | Opis |
---|---|
< | < (znak mniejszości) |
> | > (znak większości) |
& | & (ampersand) |
" | cudzysłów (") |
' | apostrof (') |
Program Flash Player oraz środowisko AIR obsługują również jawne kody znaków, jak np. & (ampersand w kodzie ASCII) czy € (symbol € w kodzie Unicode).
Implementacja
public function get htmlText():String
public function set htmlText(value:String):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
tf1
i przypisanie sformatowenego ciągu znaków HTML do jego właściwości text
. Wynikiem śledzenia tej właściwości htmlText
jest sformatowany ciąg znaków HTML z dodatkowymi znacznikami (jak np. <P> i <FONT>) automatycznie dodawanymi w programie Flash Player. Wynikiem śledzenia właściwości text
jest niesformatowany ciąg znaków bez znaczników HTML.
W celu porównania, wykonano te same czynności na kolejnym obiekcie TextField o nazwie tf2
, z tą różnicą, że do właściwości styleSheet
obiektu tf2
przypisano obiekt StyleSheet, zanim właściwość htmlText
została ustawiona. W takim przypadku, śledzenie właściwości htmlText
obejmuje jedynie sam tekst HTML, który został pierwotnie przypisany do właściwości htmlText
i wykazuje, że program Flash Player nie dodał żadnych znaczników.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
length | właściwość |
maxChars | właściwość |
maxChars:int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maksymalna liczba znaków, które użytkownik może wprowadzić w polu tekstowym. Za pomocą skryptu można wstawić więcej tekstu niż pozwala właściwość maxChars
; właściwość maxChars
oznacza maksymalną ilości tekstu wpisanego przez użytkownika. Jeśli wartość tej właściwości wynosi 0
, użytkownik może wpisać nieograniczoną ilość tekstu.
Wartością domyślną jest 0.
Implementacja
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | właściwość |
maxScrollV | właściwość |
mouseWheelEnabled | właściwość |
mouseWheelEnabled:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Wartość typu Boolean określająca, czy program Flash Player powinien automatycznie przewijać wielowierszowe pole tekstowe, gdy użytkownik kliknie na nie i poruszy pokrętłem myszy. Wartością domyślna jest wartość true
. Za pomocą tej właściwości można zablokować przewijanie tekstu za pomocą pokrętła myszy w polu tekstowym lub zaimplementować własny sposób przewijania tekstu w polu tekstowym.
Implementacja
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | właściwość |
multiline:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy pole tekstowe jest polem wielowierszowym. Wartość true
wskazuje, że pole tekstowe jest polem wielowierszowym; wartość false
wskazuje, że pole tekstowe jest polem jednowierszowym. W przypadku pola typu TextFieldType.INPUT
wartość multiline
określa, czy naciśnięcie klawisza Enter
powoduje utworzenie nowego wiersza (false
powoduje, że naciśnięcie klawisza Enter
jest ignorowane). Jeśli tekst zostanie wklejony do pola TextField
z wartością multiline
równą false
, nowe wiersze znajdują się poza tekstem.
Wartością domyślną jest false.
Implementacja
public function get multiline():Boolean
public function set multiline(value:Boolean):void
Powiązane elementy interfejsu API
numLines | właściwość |
numLines:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa liczbę wierszy w wielowierszowym polu tekstowym. Jeśli właściwość wordWrap
jest ustawiona na wartość true
, podczas zawijania tekstu liczba wierszy zwiększa się.
Implementacja
public function get numLines():int
Powiązane elementy interfejsu API
restrict | właściwość |
restrict:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Oznacza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym. Jeśli wartością właściwości restrict
jest wartość null
, użytkownik może wprowadzić dowolny znak. Jeśli wartością właściwości restrict
jest pusty ciąg znaków, użytkownik nie może wprowadzić żadnego znaku. Jeśli wartością właściwości restrict
jest ciąg znaków, użytkownik może wprowadzić do pola tekstowego tylko znaki z tego ciągu. Ciąg znaków jest przeszukiwany od lewej do prawej. Zakres można zdefiniować za pomocą znaku myślnika (-). Ograniczone są tylko interakcje użytkownika; skrypt może umieścić w polu tekstowym dowolny tekst. Tej właściwości nie można zsynchronizować z opcjami osadzania czcionki w inspektorze właściwości.
Jeśli ciąg znaków rozpoczyna się od znaku karetki (^), wszystkie znaki są początkowo akceptowane, a następujące po nich znaki w ciągu są wykluczane ze zbioru znaków akceptowanych. Jeśli ciąg znaków nie rozpoczyna się od znaku karetki (^), żadne znaki nie są początkowo akceptowane, a następujące po nich znaki w ciągu zostają zawarte w zbiorze znaków akceptowanych.
W poniższym przykładzie do pola tekstowego można wprowadzić tylko znaki dużej litery, spacje oraz liczby.
my_txt.restrict = "A-Z 0-9";
Poniższy przykład ilustruje włączenie wszystkich znaków z wyjątkiem tych pisanych małą literą:
my_txt.restrict = "^a-z";
Aby wprowadzić znaczenie znaku karetki (^) lub kreski (-) można użyć ukośnika odwrotnego. Akceptowalne sekwencje zawierające ukośnik odwrotny to: \-, \^ lub \\. Ukośnik odwrotny musi stanowić rzeczywisty znak w ciągu znaków, dlatego w języku ActionScript należy użyć podwójnego znaku ukośnika odwrotnego. Na przykład poniższy kod zawiera tylko znak kreski (-) i karetki z (^):
my_txt.restrict = "\\-\\^";
Znaku ^ można użyć w dowolnym miejscu ciągu znaków — umożliwia włączanie i wykluczanie znaków. Poniższy kod włącza tylko znaki dużych liter, ale wyłącza literę Q:
my_txt.restrict = "A-Z^Q";
Za pomocą sekwencji zmiany znaczenia \u
można budować zastrzeżone
ciągi znaków. Poniższy kod zawiera tylko znaki ASCII od numeru 32 (spacja) do 126 (tylda).
my_txt.restrict = "\u0020-\u007E";
Wartością domyślną jest null.
Implementacja
public function get restrict():String
public function set restrict(value:String):void
scrollH | właściwość |
scrollH:int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bieżące położenie podczas przewijania poziomego. Wartość 0 właściwości scrollH
oznacza, że tekst nie może być przewijany w poziomie. Wartość tej właściwości stanowi liczba całkowita, która reprezentuje położenie w poziomie wyrażone w pikselach.
Jednostką dla przewijania w poziomie są piksele, a dla przewijania w pionie — wiersze. Przewijanie w poziomie jest mierzone w pikselach, ponieważ większość zazwyczaj używanych czcionek jest równomiernie rozłożona, co oznacza, że znaki mogą mieć różną szerokość. Przewijanie w pionie w programie Flash Player odbywa się według wierszy, ponieważ użytkownicy zazwyczaj wolą wyświetlić pełny, a nie częściowy wiersz tekstowy. Nawet w przypadku, gdy w wierszu znajdują się różne czcionki, wysokość wiersza jest dostosowywana do największej z nich.
Uwaga: Zbiór liczb dla właściwości scrollH
rozpoczyna się od liczby 0, a nie liczby 1, jak dla właściwości przewijania w pionie scrollV
.
Implementacja
public function get scrollH():int
public function set scrollH(value:int):void
Powiązane elementy interfejsu API
scrollV | właściwość |
scrollV:int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Pionowe położenie tekstu w polu tekstowym. Właściwość scrollV
pomaga nawigować do konkretnego akapitu w długim ustępie lub tworzyć przewijane pola tekstowe.
Jednostką dla przewijania w pionie są wiersze, a dla przewijania w poziomie — piksele. Jeśli pierwszy wyświetlany wiersz to pierwszy wiersz pola tekstowego, właściwość scrollV przyjmuje wartość 1 (nie 0). Przewijanie w poziomie jest mierzone w pikselach ponieważ większość czcionek jest równomiernie rozłożona, co oznacza, że znaki mogą mieć różną szerokość. Przewijanie w pionie w programie Flash Player odbywa się według wierszy, ponieważ użytkownicy zazwyczaj chcą wyświetlić pełny, a nie częściowy wiersz tekstowy. Nawet w przypadku, gdy w wierszu znajdują się różne czcionki, wysokość wiersza jest dostosowywana do największej z nich.
Implementacja
public function get scrollV():int
public function set scrollV(value:int):void
Powiązane elementy interfejsu API
selectable | właściwość |
selectable:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość typu Boolean wskazująca, czy dane pole tekstowe można zaznaczać. Wartość true
oznacza, że tekst można zaznaczać. Właściwość selectable
udostępnia sterowanie możliwością zaznaczenia, a nie edycji pola tekstowego. Dynamiczne pole tekstowe można zaznaczać nawet, gdy nie można go wyedytować. Jeśli dynamiczne pole tekstowe nie ma możliwości zaznaczenia, użytkownik nie może zaznaczyć w nim tekstu.
Jeśli właściwość selectable
jest ustawiona na wartość false
, tekst w polu tekstowym nie będzie reagował na polecenia zaznaczenia lub ich skróty klawiszowe i nie będzie go można skopiować za pomocą polecenia Kopiuj. Jeśli właściwość selectable
jest ustawiona na wartość true
, tekst w polu tekstowym można zaznaczyć za pomocą myszy lub klawiszy klawiatury i skopiować za pomocą polecenia Kopiuj. W ten sposób można zaznaczyć tekst, nawet jeśli pole tekstowe to dynamiczne, a nie wejściowe pole tekstowe.
Wartością domyślną jest true.
Implementacja
public function get selectable():Boolean
public function set selectable(value:Boolean):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
selectable
ustawiono na wartość true
, a w drugim właściwość selectable
ma wartość false
. W przypadku korzystania z tego przykładu należy spróbować zaznaczyć tekst w tych polach za pomocą myszy lub klawiatury.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class selectableExample extends Sprite { public function selectableExample() { var tf1:TextField = createCustomTextField(10, 10); tf1.text="This text can be selected"; tf1.selectable=true; var tf2:TextField = createCustomTextField(10, 30); tf2.text="This text cannot be selected"; tf2.selectable=false; } private function createCustomTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } }
selectionBeginIndex | właściwość |
selectionBeginIndex:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indeks pierwszego znaku w bieżącym zaznaczeniu, liczony od 0. Na przykład, liczba dla pierwszego znaku to 0, dla drugiego to 1, itd. W przypadku braku zaznaczenia, ta właściwości przyjmuje wartość właściwości caretIndex
.
Implementacja
public function get selectionBeginIndex():int
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
printCursorPosition
w momencie kliknięcia pola tekstowego TextField. W takim przypadku wartości wynikowe właściwości caretIndex
, selectionBeginIndex
oraz selectionEndIndex
stanowią wartości wyjściowe.
Należy wykonać czynności przedstawione w przykładzie i spróbować kliknąć obszar w polu tekstowym w celu zaznaczenia tekstu. Następnie należy kliknąć pole, nie zaznaczając tekstu. Podczas klikania tekstu bez zaznaczenia właściwość caretIndex
wskazuje punkt wstawiania, a właściwości selectionBeginIndex
oraz selectionEndIndex
są równe wartości właściwości caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
selectionEndIndex | właściwość |
selectionEndIndex:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indeks ostatniego znaku w bieżącym zaznaczeniu, liczony od 0. Na przykład, liczba dla pierwszego znaku to 0, dla drugiego to 1, itd. W przypadku braku zaznaczenia, ta właściwości przyjmuje wartość właściwości caretIndex
.
Implementacja
public function get selectionEndIndex():int
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
printCursorPosition
w momencie kliknięcia pola tekstowego TextField. W takim przypadku wartości wynikowe właściwości caretIndex
, selectionBeginIndex
oraz selectionEndIndex
stanowią wartości wyjściowe.
Należy wykonać czynności przedstawione w przykładzie i spróbować kliknąć obszar w polu tekstowym w celu zaznaczenia tekstu. Następnie należy kliknąć pole, nie zaznaczając tekstu. Podczas klikania tekstu bez zaznaczenia właściwość caretIndex
wskazuje punkt wstawiania, a właściwości selectionBeginIndex
oraz selectionEndIndex
są równe wartości właściwości caretIndex
.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
sharpness | właściwość |
sharpness:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Ostrość krawędzi glifów w polu tekstowym. Ta właściwość ma zastosowanie tylko w przypadku, gdy właściwość flash.text.AntiAliasType
pola tekstowego jest ustawiona na wartość flash.text.AntiAliasType.ADVANCED
. Zakres wartości dla właściwości sharpness
stanowi zbiór liczb od -400 do 400. W przypadku próby ustawienia dla właściwości sharpness
wartości spoza tego zakresu, wartość dla tej właściwości w programie Flash zostanie ustawiona na najbliższą możliwą wartość zakresu (albo -400 albo 400).
Wartością domyślną jest 0.
Implementacja
public function get sharpness():Number
public function set sharpness(value:Number):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
sharpness
na obiekt TextField. Konieczne jest osadzenie czcionki oraz ustawienie właściwości antiAliasType
na wartość ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class sharpnessExample extends Sprite { public function sharpnessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-400); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,400); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.sharpness=fldSharpness; result..setTextFormat(format); addChild(result); return result; } } }
styleSheet | właściwość |
styleSheet:StyleSheet
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dołącza do pola tekstowego arkusz stylu. Więcej informacji na temat tworzenia arkuszy stylów, zawiera opis klasy StyleSheet oraz publikacja ActionScript 3.0 — Podręcznik dla programistów.
Zmiany arkuszy stylów powiązanych z danym polem tekstowym można dokonać w dowolnym momencie. Jeśli arkusz stylów, który jest w użyciu zostanie zmieniony, pole tekstowe zostaje ponownie narysowane z użyciem nowego arkusza stylów. Aby usunąć arkusz stylów, należy ustawić jego wartość na null
lub undefined
. Jeśli używany arkusz stylów zostanie usunięty, pole tekstowe zostaje ponownie narysowane bez arkusza stylów.
Uwaga: Jeśli arkusz stylów zostanie usunięty, zawartości obydwu właściwości TextField.text
i TextField.htmlText
zostanie przywrócone formatowanie zastosowane przy użyciu wcześniejszego arkusza stylów. Aby zachować pierwotną zawartość właściwości TextField.htmlText
bez formatowania, przed usunięciem arkusza stylów należy zapisać wartość w zmiennej.
Implementacja
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
stylesheet
przed określeniem zawartości.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.StyleSheet; public class TextStylesheetExample extends Sprite { var myLabel:TextField = new TextField(); var labelText:String = "Hello world."; var newStyle:StyleSheet = new StyleSheet(); public function TextStylesheetExample() { var styleObj:Object = new Object(); styleObj.fontWeight = "bold"; styleObj.color = "#660066"; newStyle.setStyle(".defStyle", styleObj); myLabel.styleSheet=newStyle; myLabel.htmlText=labelText; addChild(myLabel); } } }
text | właściwość |
text:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ciąg znaków odpowiadający bieżącemu tekstowi w polu tekstowym. Wiersze są rozdzielone za pomocą znaku powrotu karetki ('\r'
, ASCII 13). Ta właściwość określa niesformatowany tekst w polu tekstowym, bez znaczników HTML.
Aby pobrać tekst w formacie HTML, należy użyć właściwości htmlText
.
Uwaga: Jeśli do pola tekstowego zostanie zastosowany arkusz stylów, zawartość właściwości text
zostanie potraktowana jak kod HTML.
Implementacja
public function get text():String
public function set text(value:String):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
tf1
i przypisanie sformatowenego ciągu znaków HTML do jego właściwości text
. Wynikiem śledzenia tej właściwości htmlText
jest sformatowany ciąg znaków HTML z dodatkowymi znacznikami (jak np. <P> i <FONT>) automatycznie dodawanymi w programie Flash Player. Wynikiem śledzenia właściwości text
jest niesformatowany ciąg znaków bez znaczników HTML.
W celu porównania, wykonano te same czynności na kolejnym obiekcie TextField o nazwie tf2
, z tą różnicą, że do właściwości styleSheet
obiektu tf2
przypisano obiekt StyleSheet, zanim właściwość htmlText
została ustawiona. W takim przypadku, śledzenie właściwości htmlText
obejmuje jedynie sam tekst HTML, który został pierwotnie przypisany do właściwości htmlText
i wykazuje, że program Flash Player nie dodał żadnych znaczników.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textColor | właściwość |
textColor:uint
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kolor tekstu w polu tekstowym (w formacie szesnastkowym). W szesnastkowym systemie kolorów wartości kolorów są reprezentowane za pomocą sześciu cyfr. Dla każdej cyfry istnieje szesnaście możliwych wartości lub znaków. Zakres znaków obejmuje cyfry od 0 do 9, a następnie litery od A do F. Na przykład reprezentacja koloru czarnego 0x000000
, a białego to 0xFFFFFF
.
Wartością domyślną jest 0 (0x000000).
Implementacja
public function get textColor():uint
public function set textColor(value:uint):void
Przykład ( Sposób korzystania z tego przykładu )
textColor
zostaje zmieniona na kolor czerwony (0xFF0000
).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textColor extends Sprite { public function TextField_textColor() { var tf:TextField = createCustomTextField(10, 10, 100, 300); tf.text = "This will be red text"; tf.textColor = 0xFF0000; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textHeight | właściwość |
textHeight:Number
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wysokość tekstu w pikselach.
Implementacja
public function get textHeight():Number
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
trace
wyświetlane są wartości dla właściwości textWidth
i textHeight
. W celu porównania wyświetlane są również właściwości width
oraz height
. (Należy pamiętać, że wartości wyświetlane dla właściwości textHeight
i textWidth
mogą być różne w zależności od czcionki wykorzystywanej na danym komputerze).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
textInteractionMode | właściwość |
textInteractionMode:String
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Właściwość trybu interakcji, której wartością domyślną jest TextInteractionMode.NORMAL. Na platformach (urządzeniach) przenośnych tryb normalny sugeruje, że tekst można przewijać, ale nie można go zaznaczać. Tryb zaznaczania można uaktywniać za pośrednictwem wbudowanego menu kontekstowego w polu tekstowym. Na komputerze stacjonarnym tryb normalny sugeruje, że tekst można przewijać, a także zaznaczać.
Implementacja
public function get textInteractionMode():String
textWidth | właściwość |
textWidth:Number
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Szerokość tekstu w pikselach.
Implementacja
public function get textWidth():Number
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
trace
wyświetlane są wartości dla właściwości textWidth
i textHeight
. W celu porównania wyświetlane są również właściwości width
oraz height
. (Należy pamiętać, że wartości wyświetlane dla właściwości textHeight
i textWidth
mogą być różne w zależności od czcionki wykorzystywanej na danym komputerze).
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
thickness | właściwość |
thickness:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Grubość krawędzi glifów w polu tekstowym. Ta właściwość ma zastosowanie tylko wówczas, gdy właściwość flash.text.AntiAliasType
jest ustawiona na wartość flash.text.AntiAliasType.ADVANCED
.
Zakres wartości dla właściwości thickness
stanowi zbiór liczb od -200 do 200. W przypadku próby ustawienia dla właściwości thickness
wartości spoza tego zakresu, wartość dla tej właściwości zostanie ustawiona na najbliższą możliwą wartość zakresu (albo -200 albo 200).
Wartością domyślną jest 0.
Implementacja
public function get thickness():Number
public function set thickness(value:Number):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
thickness
na obiekt TextField. Konieczne jest osadzenie czcionki oraz ustawienie właściwości antiAliasType
na wartość ADVANCED
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class thicknessExample extends Sprite { public function thicknessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-200); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,200); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.thickness=fldThickness; result.setTextFormat(format); addChild(result); return result; } } }
type | właściwość |
type:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Typ pola tekstowego. Jedna z dwóch następujących stałych TextFieldType: TextFieldType.DYNAMIC
określająca dynamiczne pole tekstowe, którego użytkownik nie może edytować lub TextFieldType.INPUT
określająca wejściowe pole tekstowe, które użytkownik może edytować.
Wartością domyślną jest dynamic.
Implementacja
public function get type():String
public function set type(value:String):void
Zgłasza
ArgumentError — Określona właściwość type nie należy do typu flash.text.TextFieldType.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
tfDynamic
oraz tfInput
. Tekst zostaje wprowadzony do obydwu pól tekstowych. Jednakże, właściwość type
pola tekstowego tfDynamic
została ustawiona na wartość TextFieldType.DYNAMIC
, a właściwość type
pola tekstowego tfInput
została ustawiona na wartość TextFieldType.INPUT
. W ten oto sposób tekst w polu tfInput
można modyfikować, ale tekst w polu tfDynamic
można tylko wyświetlić.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_type extends Sprite { public function TextField_type() { var tfDynamic:TextField = createCustomTextField(10, 10, 100, 20); tfDynamic.type = TextFieldType.DYNAMIC; tfDynamic.text = "hello"; var tfInput:TextField = createCustomTextField(10, 45, 100, 20); tfInput.type = TextFieldType.INPUT; tfInput.text = "world"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
useRichTextClipboard | właściwość |
useRichTextClipboard:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa, czy razem z tekstem można kopiować i wklejać jego format. W przypadku ustawienia wartości true
program Flash Player kopiuje i wkleja formatowanie (takie jak wyrównanie, pogrubienie lub kursywa) podczas kopiowania i wklejania między polami tekstowymi. W celu przeprowadzenia procedury kopiuj i wklej, obydwa pola tekstowe (źródłowe i docelowe) powinny dla właściwości useRichTextClipboard
mieć ustawioną wartość true
. Wartością domyślną jest false
.
Implementacja
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
Przykład ( Sposób korzystania z tego przykładu )
tf1
) oraz dwóch dynamicznych pól tekstowych (tf2
i tf3
). Kod ten przypisuje każdemu dynamicznemu polu tekstowemu obiekt TextFormat (czcionka Courier Bold). Tekst tf2
ma właściwość useRichTextClipboard
ustawioną na wartość false
. Tekst tf3
ma właściwość useRichTextClipboard
ustawioną na wartość true
. W przypadku skopiowania tekstu z pola tekstowego tf2
i wklejenia go do pola tf1
formatowanie wklejanego tekstu jest zachowywane. W przypadku kopiowania tekstu z pola tekstowego tf3
(którego właściwość useRichTextClipboard
jest ustawiona na wartość true
) oraz wklejania go do pola tekstowego tf1
formatowanie wklejanego tekstu jest zachowywane.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; public class useRichTextClipboard extends Sprite { public function useRichTextClipboard() { var format1:TextFormat = new TextFormat(); format1.font="Courier"; format1.bold=true; var tf1:TextField = createCustomTextField(10, 10, 200, 20); tf1.type=TextFieldType.INPUT; tf1.useRichTextClipboard=true; var tf2:TextField = createCustomTextField(220, 10, 200, 20); tf2.text="1.Text loses format"; tf2.setTextFormat(format1); tf2.useRichTextClipboard=false; var tf3:TextField = createCustomTextField(220, 50, 200, 20); tf3.text="2.Text includes format"; tf3.setTextFormat(format1); tf3.useRichTextClipboard=true; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
wordWrap | właściwość |
wordWrap:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wartość typu Boolean wskazująca, że tekst w polu tekstowym może być zawijany. Dla wartości true
właściwości wordWrap
tekst w polu tekstowym będzie zawijany; dla wartości false
, tekst w polu tekstowym nie będzie zawijany. Wartością domyślną jest false
.
Implementacja
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
Przykład ( Sposób korzystania z tego przykładu )
wordWrap
na wartość true
, a jej ustawieniem na wartość false
. Utworzone zostały dwie instancje TextField, których zawartość jest za duża dla ich szerokości. Właściwość wordWrap
dla pierwszego obiektu (o nazwie tfWrap
) została ustawiona na wartość true
; dla drugiego obiektu (tfNoWrap
) właściwość została ustawiona na wartość false
.
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_wordWrap extends Sprite { public function TextField_wordWrap() { var tfWrap:TextField = createCustomTextField(10, 10, 100, 100); tfWrap.wordWrap = true; tfWrap.text = "(wordWrap = true):\nThis is very long text that will certainly extend beyond the width of this text field"; var tfNoWrap:TextField = createCustomTextField(10, 150, 100, 100); tfNoWrap.wordWrap = false; tfNoWrap.text = "(wordWrap = false):\nThis is very long text that will certainly extend beyond the width of this text field"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
TextField | () | Konstruktor |
public function TextField()
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy nową instancję klasy TextField. Po utworzeniu instancji TextField, należy wywołać metodę addChild()
lub addChildAt()
obiektu nadrzędnego DisplayObjectContainer, w celu dodania instancji TextField do listy wyświetlania.
Domyślna wielkość pola tekstowego wynosi 100 x 100 pikseli.
Przykład ( Sposób korzystania z tego przykładu )
var theTextField:TextField = new TextField(); theTextField.type = TextFieldType.INPUT; theTextField.border = true; theTextField.x = 10; theTextField.y = 10; theTextField.multiline = true; theTextField.wordWrap = true; addChild(theTextField);
appendText | () | metoda |
public function appendText(newText:String):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dołącza ciąg wskazany w parametrze newText
na końcu tekstu w polu tekstowym. Ta metoda jest bardziej wydajna niż przypisanie dołączenia (+=
) we właściwości text
(takiej jak someTextField.text += moreText
), zwłaszcza w przypadku pola tekstowego, które zawiera znaczną ilość tekstu.
Parametry
newText:String — Ciąg znaków, który dołącza się do istniejącego tekstu.
|
Przykład ( Sposób korzystania z tego przykładu )
Ustawienie pola tekstowego outputText
powoduje automatycznie dopasowanie tekstu i jego wyrównanie do lewej strony za pomocą właściwości autoSize
. Za pomocą właściwości outputText.text
zostaje zapisany pierwszy wiersz zawartości, a reszta zawartości zostaje dołączona przy użyciu metody appendText()
. (Rozpoczęcie od właściwości text
nie jest konieczne. Za pomocą metody appendText()
można również od razu dołączyć tekst). Powtórne ustawienie właściwości text
spowoduje nadpisanie pierwotnego tekstu. Aby dołączyć zawartość we właściwości text
, należy użyć operatora +=
.
Wyrażenie if
sprawdza czy dana data to sobota (6) czy niedziela (0). W przeciwnym przypadku metoda toLocaleTimeString()
zwraca czas lokalny, który zostaje dołączony do zawartości pola tekstowego.
Za pomocą właściwości length
pola tekstowego można odczytać liczbę znaków bezpośrednio przed wywołaniem funkcji, a za pomocą właściwości numLines
można policzyć liczbę linii w polu tekstowym. Należy pamiętać, że liczba linii zawiera również linie puste, a wartość długości zawartości zawiera również puste znaki oraz linie podziału.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_appendTextExample extends Sprite { public function TextField_appendTextExample() { var outputText:TextField = new TextField(); var today:Date = new Date(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.text = "WHAT TIME IS IT?" + "\n\n"; if((today.day == 0) || (today.day == 6)) { outputText.appendText("It's the weekend."); outputText.appendText("\n\n"); } else { outputText.appendText("The time is: "); outputText.appendText(today.toLocaleTimeString() + ".\n\n"); } outputText.appendText("Number of characters including line breaks and spaces so far: "); outputText.appendText(outputText.length.toString() + "\n"); outputText.appendText("Number of lines in the outputText: "); outputText.appendText(outputText.numLines.toString()); this.addChild(outputText); } } }
getCharBoundaries | () | metoda |
public function getCharBoundaries(charIndex:int):Rectangle
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca prostokąt będący obwiednią znaku.
Parametry
charIndex:int — Indeks znaku liczony od 0 (na przykład pierwsza pozycja to 0, druga to 1, itd.).
|
Rectangle — Prostokąt z minimalnymi i maksymalnymi wartościami x oraz y definiujący obwiednię znaku.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
getCharBoundaries()
do oznaczania (podświetlenia) znaku zaznaczonego przez użytkownika.
Klasa definiuje obiekt Shape o nazwie spotlight
, który zostanie wykorzystany do narysowania prostokąta wokół każdego zaznaczonego znaku. Kliknięcie pola tekstowego myTextField
wywołuje metodę clickHandler()
.
W metodzie clickHandler()
metoda getCharIndexAtPoint()
pobiera indeks klikniętego znaku w oparciu o współrzędne localX
i localY
miejsca kliknięcia myszą, określane względem ikonki Sprite
. Metoda getCharIndexAtPoint()
zwraca wartość -1
, jeśli punkt (kliknięcia myszą) nie był poza znakiem. Ponieważ pole tekstowe może być większe niż sam tekst, zwrócona liczba całkowita (index
) informuje czy użytkownik kliknął znak. Metoda getCharBoundaries()
również wykorzystuje liczbę całkowitą index
do pobrania obiektu Rectangle
, który określa granice znaku. Za pomocą metody clear()
można wyczyścić wcześniej wyświetlony obiekt Shape spotlight
. W miejscu znaku zostaje wygenerowany nowy prostokąt o granicznej długości i szerokości znaku (przesunięcie w stosunku do współrzędnych: 10, 10) za pomocą zwróconych współrzędnych x i y prostokąta frame
. Aby podświetlić znak, obiekt Shape spotlight
zostaje wypełniony żółtym kolorem, a wartość krycia zostaje ustawiona na 35 procent, tak aby znak był również widoczny. Należy pamiętać, że spacje są również traktowane jako znaki.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; import flash.display.Shape; public class TextField_getCharBoundariesExample extends Sprite { private var myTextField:TextField = new TextField(); private var spotlight:Shape = new Shape(); public function TextField_getCharBoundariesExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.selectable = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "Selected a character from this text by clicking on it." myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(spotlight); } private function clickHandler (e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { var frame:Rectangle = myTextField.getCharBoundaries(index); spotlight.graphics.clear(); spotlight.graphics.beginFill(0xFFFF00, .35); spotlight.graphics.drawRect((frame.x + 10), (frame.y + 10), frame.width, frame.height); spotlight.graphics.endFill(); } } } }
getCharIndexAtPoint | () | metoda |
public function getCharIndexAtPoint(x:Number, y:Number):int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca indeks znaku liczony od 0 w punkcie określonym parametrami x
i y
.
Parametry
x:Number — Współrzędna x znaku.
| |
y:Number — Współrzędna y znaku.
|
int — Indeks znaku liczony od 0 (na przykład pierwsza pozycja to 0, druga to 1, itd.). Zwraca wartość -1, jeśli punkt nie należy do żadnego znaku.
|
Przykład ( Sposób korzystania z tego przykładu )
Pierwsze pole tekstowe zawiera tekst, który użytkownik zamierza zaznaczyć. Aby spowodować kliknięcie, ale nie zaznaczenie tekstu, należy ustawić właściwość selectable
na wartość fałsz. Kliknięcie pola tekstowego firstTextField
powoduje wywołanie metody clickHandler()
.
W metodzie clickHandler()
, metoda getCharIndexAtPoint()
zwraca indeks znaku w oparciu o współrzędne localX
oraz localY
punktu kliknięcia myszą. Ponieważ pole tekstowe może zawierać więcej znaków niż zawiera tekst, zwrócona liczba całkowita (index
) jest sprawdzana w celu upewnienia się, czy użytkownik kliknął znak. (Metoda getCharIndexAtPoint()
zwraca wartość -1
, jeśli (punkt kliknięcia myszą) (mouse click) nie był poza znakiem). Współrzędne myszy służą do ustalenia współrzędnych nowego pola tekstowego, w którym pojawi się odwzorowanie znaku. Kolor znaku w drugim polu tekstowym to kolor czerwony. Na końcu, tekst w drugim polu tekstowym jest ustawiany na zaznaczony znak, który został pobrany za pomocą metody charAt()
. Należy pamiętać, że korzystanie z właściwości text
zamiast metody appendText()
spowoduje, że znak w drugim polu zostanie nadpisany, a nie dołączony.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; public class TextField_getCharIndexAtPointExample extends Sprite { private var firstTextField:TextField = new TextField(); private var secondTextField:TextField = new TextField(); public function TextField_getCharIndexAtPointExample() { firstTextField.x = 100; firstTextField.y = 100; firstTextField.width = 260; firstTextField.height = 20; firstTextField.border = true; firstTextField.background = true; firstTextField.selectable = false; firstTextField.text = "Selected a character from this text by clicking on it." firstTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(firstTextField); this.addChild(secondTextField); } private function clickHandler (e:MouseEvent):void { var index:int = firstTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { secondTextField.x = mouseX; secondTextField.y = 70; secondTextField.border = true; secondTextField.selectable = false; secondTextField.background = true; secondTextField.textColor = 0xFF0000; secondTextField.autoSize = TextFieldAutoSize.LEFT; secondTextField.text = firstTextField.text.charAt(index); } } } }
getFirstCharInParagraph | () | metoda |
public function getFirstCharInParagraph(charIndex:int):int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Po otrzymaniu indeksu znaku zwraca indeks pierwszego znaku w tym samym akapicie.
Parametry
charIndex:int — Indeks znaku liczony od 0 (na przykład pierwszy znak to 0, drugi to 1, itd.).
|
int — Indeks pierwszego znaku w tym samym akapicie, liczony od 0.
|
Zgłasza
RangeError — Określony indeks znaków jest poza zakresem.
|
Przykład ( Sposób korzystania z tego przykładu )
Konstruktor w polu tekstowym myTextField
został ustawiony na zawijanie tekstu. Metoda getTextFormat
zwraca pierwotne formatowanie pierwszego znaku zawartości pola tekstowego, które znajduje się w obiekcie TextFormat pod nazwą originalFormat
. Zdefiniowany zostaje również nowy obiekt TextFormat (newFormat
), a jego właściwość align
zostaje przypisana wartość wyrównania do prawej. Kliknięcie na pole tekstowe wywołuje metodę clickHandler()
.
W metodzie clickHandler()
, metoda getCharIndexAtPoint()
zwraca indeks znaku w oparciu o współrzędne localX
oraz localY
punktu kliknięcia myszą. Pierwsza instrukcja if
sprawdza, czy został kliknięty znak. Na podstawie liczby całkowitej clickIndex
zwróconej przez metodę getCharIndexAtPoint()
metoda getFirstCharInParagraph()
zwraca indeks pierwszego znaku klikniętego akapitu. Indeks ostatniego znaku akapitu zostaje określony poprzez dodanie wartości długości akapitu (za pomocą metody getParagraphLength()
) do indeksu pierwszego znaku akapitu i odjęcie ostatniego znaku (\n
). Druga instrukcja warunkowa if
sprawdza format pierwszego znaku akapitu. Jeśli jego wartość jest taka sama, jak wartość pierwotnego formatowania (wyrównanie do lewej), wówczas do wszystkich znaków w akapicie zostaje dodany nowy format. W przeciwnym razie format akapitu zostaje ustawiony na format pierwotny. Wyrównanie, wraz z formatowaniem takim jak wcięcie, wypunktowanie, punkty tabulacji, prawy i lewy margines stanowią elementy formatowania przeznaczonymi dla akapitu. Należy pamiętać, że ustawienie zawijania tekstu czy linii podziału wiersza będzie miało zastosowanie tylko do pierwszego wiersza akapitu, jeśli dla metody setTextFormat()
nie zostanie zdefiniowany argument endIndex
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFormatAlign; public class TextField_getFirstCharInParagraphExample extends Sprite { private var myTextField:TextField = new TextField(); private var originalFormat:TextFormat = new TextFormat(); private var newFormat:TextFormat = new TextFormat(); public function TextField_getFirstCharInParagraphExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 300; myTextField.background = true; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime.\n\n"); originalFormat = myTextField.getTextFormat(0); newFormat.align = TextFormatAlign.RIGHT; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var clickIndex:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(clickIndex != -1) { var paragraphFirstIndex:int = myTextField.getFirstCharInParagraph(clickIndex); var paragraphEndIndex:int = paragraphFirstIndex + ((myTextField.getParagraphLength(clickIndex) - 1)); if (myTextField.getTextFormat(paragraphFirstIndex).align == originalFormat.align) { myTextField.setTextFormat(newFormat, paragraphFirstIndex, paragraphEndIndex); }else { myTextField.setTextFormat(originalFormat, paragraphFirstIndex, paragraphEndIndex); } } } } }
getImageReference | () | metoda |
public function getImageReference(id:String):DisplayObject
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca odwołanie do obiektu DisplayObject o podanym identyfikatorze id
. Operacja dotyczy obrazu lub pliku SWF, które dodano do sformatowanego pola tekstowego HTML za pomocą znacznika <img>
. Znacznik <img>
jest w następującym formacie:
<img src = 'filename.jpg' id = 'instanceName' >
Parametry
id:String — Identyfikator id , który ma być zgodny (w atrybucie id znacznika <img> ).
|
DisplayObject — Obiekt wyświetlany, który odpowiada obrazowi lub plikowi SWF o atrybucie id podanym w znaczniku <img> pola tekstowego. Ten obiekt to obiekt Loader ładujący multimedia z zewnętrznego źródła, który po załadowaniu staje się obiektem podrzędnym obiektu ładującego Loader. Dla multimediów osadzonych w pliku SWF jest to obiekt załadowany. Jeśli nie istnieje żaden znacznik <img> ze zgodną wartością id , metoda zwraca null .
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Obraz (image.jpg
) jest włączany za pośrednictwem kodu HTML. (Zakłada się, że plik obrazu znajduje się w tym samym katalogu co plik SWF). Aby uzyskać dostęp do obrazu za pomocą metody getImageReference()
, należy zdefiniować atrybut id
dla znacznika img
. Właściwość htmlText
wykorzystuje się do włączenia zawartości ciągu znaków sformatowanych za pomocą języka HTML. Kliknięcie pola tekstowego myTextField
wywołuje metodę clickHandler()
.
W metodzie clickHandler()
metoda getImageReference()
zwraca odwołanie do obrazu w formie obiektu DisplayObject
. Za pomocą tego odwołania można sterować obrazem, w taki sam sposób, jak dowolnym obiektem DisplayObject
. Tutaj można ustawić właściwości alpha
(przezroczystość) oraz rotation
. Dzięki właściwości transform
można uzyskać dostęp do matrycy obiektu wyświetlanego, uzyskać dostęp do transformacji koloru oraz obwiedni w pikselach. Należy pamiętać o konieczności zaimportowania obiektu flash.display.DisplayObject
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.Event; import flash.events.MouseEvent; import flash.display.DisplayObject; import flash.text.TextFieldAutoSize; public class TextField_getImageReferenceExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_getImageReferenceExample() { var myText1:String = "<p>Here is an image we want to mainpulate: <img src='image.jpg' id='testimage'></p>"; myTextField.x = 10; myTextField.y = 10; myTextField.width = 250; myTextField.height = 250; myTextField.background = true; myTextField.border = true; myTextField.border = true; myTextField.multiline = true; myTextField.htmlText = myText1; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var imageRef:DisplayObject = myTextField.getImageReference("testimage"); imageRef.rotation += 90; imageRef.x = 125; imageRef.y = 125; imageRef.alpha = 0.25; } } }
getLineIndexAtPoint | () | metoda |
public function getLineIndexAtPoint(x:Number, y:Number):int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca liczony od 0 indeks wiersza o podanym położeniu określonym przez parametry x
i y
.
Parametry
x:Number — Współrzędna x wiersza.
| |
y:Number — Współrzędna y wiersza.
|
int — Indeks wiersza liczony od 0 (na przykład wartość pierwszego wiersza to 0, drugiego to 1, itd.). Zwraca wartość -1, jeśli punkt nie znajduje się ponad wierszem.
|
Przykład ( Sposób korzystania z tego przykładu )
W konstruktorze pole tekstowe poem
nie jest ustawione na zawijanie (ponieważ jest to wiersz). Wykorzystano tu również właściwość autoSize
do automatycznego dopasowania i wyrównania tekstu do lewej strony. Pole tekstowe poemCopy
zostaje umieszczone za polem tekstowym poem
. Kliknięcie dowolnego wersu wiersza spowoduje wywołanie metody clickHandler()
.
W metodzie clickHandler()
metoda getLineIndexAtPoint()
zwraca indeks klikniętego wiersza na podstawie wartości współrzędnych localX
i localY
punktu kliknięcia myszą. (Ponieważ pierwotny wiersz pasuje do rozmiarów aktualnego pola tekstowego, nie ma potrzeby sprawdzania, czy nie wystąpił błąd położenia poza obszarem (RangeError
), który zostałby zwrócony za pomocą metody getCharIndexAtPoint()
). Następnie indeks wiersza używany jest do pobrania zawartości wiersza jako ciągu znaków za pomocą metody getLineText()
, a ciąg ten jest potem dołączany do zawartości pola tekstowego poemCopy
. Kopiowanie może trwać nadal, ale po osiągnięciu pewnej granicy, tekst znajdzie się poza widocznym obszarem pola tekstowego poemCopy
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexAtPointExample extends Sprite { private var poem:TextField = new TextField(); private var poemCopy:TextField = new TextField(); public function TextField_getLineIndexAtPointExample() { poem.border = true; poem.autoSize = TextFieldAutoSize.LEFT; poem.x = 10; poem.wordWrap = false; poemCopy.height = 250; poemCopy.width = 270; poemCopy.y = 230; poemCopy.x = 10; poemCopy.background = true; poemCopy.border = true; poemCopy.wordWrap = false; poem.appendText("Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved."); poem.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(poem); this.addChild(poemCopy); } private function clickHandler(e:MouseEvent):void { var index:int = poem.getLineIndexAtPoint(e.localX, e.localY); var s:String; s = poem.getLineText(index); poemCopy.appendText(s + "\n"); } } }
getLineIndexOfChar | () | metoda |
public function getLineIndexOfChar(charIndex:int):int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca liczony od 0 indeks wiersza zawierającego znak określony przez parametr charIndex
.
Parametry
charIndex:int — Indeks znaku liczony od 0 (na przykład pierwszy znak to 0, drugi to 1 itd.).
|
int — Indeks wiersza liczony od 0.
|
Zgłasza
RangeError — Określony indeks znaków jest poza zakresem.
|
Przykład ( Sposób korzystania z tego przykładu )
getLineIndexOfChar()
zwraca numer wiersza dla 100 i 500 znaku w polu tekstowym.
Dla pola tekstowego myTextField
określono ustawienia zawijania i wyrównania tekstu do lewej strony. Metoda getLineIndexOfChar()
zwraca indeks wiersza dla określonych indeksów znaków (100 i 500). Następnie ta informacje zostaje dołączona na końcu akapitu. Indeks wiersza zaczyna się od wartości 0, dlatego indeks wiersza (index
) zostanie powiększony o 1 w celu uzyskania numeru wiersza. Jeśli wielkość wyświetlanego tekstu legnie zmianie, zmienić się może również numer wiersza. Jednakże dołączona informacja pozostanie taka sama, ponieważ metoda jest wywoływana tylko raz.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexOfCharExample extends Sprite { public function TextField_getLineIndexOfCharExample() { var myTextField:TextField = new TextField(); myTextField.x = 10; myTextField.y = 10; myTextField.width = 200; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n"); var index:int = myTextField.getLineIndexOfChar(100); myTextField.appendText("100th character is in line: " + (index + 1) + "\n"); index = myTextField.getLineIndexOfChar(500); myTextField.appendText("500th character is in line: " + (index + 1)); this.addChild(myTextField); } } }
getLineLength | () | metoda |
public function getLineLength(lineIndex:int):int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca liczbę znaków w określonym wierszu tekstowym.
Parametry
lineIndex:int — Numer wiersza, dla którego długość użytkownik zamierza określić.
|
int — Liczba znaków w wierszu.
|
Zgłasza
RangeError — Numer określonego wiersza znajduje się poza obszarem.
|
Przykład ( Sposób korzystania z tego przykładu )
W celu zilustrowania przykładu pole tekstowe myTextField
wyświetlające tekst, który będzie zliczany, zostaje ustawione na wartość INPUT
, co oznacza, że użytkownicy mogą zmieniać wiersze, dodawać kolejne wiersze między nimi lub na końcu istniejących wierszy. (Za pomocą znaku podziału (\n
) umieszczonego na końcu ostatniego wiersza został utworzony nowy pusty wiersz). Pole tekstowe countLines
, które wyświetla wynik zliczania długości wiersza znajduje się poniżej pola tekstowegomyTextField
, a jego tekstu nie można zaznaczyć. Kliknięcie na wiersz w polu tekstowym myTextField
spowoduje wywołanie metody clickHandler()
.
W metodzie clickHandler()
metoda getLineIndexAtPoint()
zwraca indeks klikniętego wiersza za pomocą współrzędnych localX
i localY
punktu kliknięcia myszą. Instrukcja warunkowa if
sprawdza, czy użytkownik kliknął znak. Jeśli tak, metoda getLineLength()
zwraca wartość liczby znaków w wierszu w oparciu o indeks wiersza. Należy pamiętać, że puste wiersze pomiędzy wierszami zawierają drugi znak podziału (\n
), a liczba znaków w wierszu to 1, podczas gdy liczba znaków dla wiersza znajdującego się po ostatnim wierszu wynosi 0. Spacje są również liczone jako jeden znak. Jeśli użytkownik napisze nowy wiersz lub zmieni dowolny wiersz, klikając go może wyświetlić liczbę znaków w wierszu. Jeśli zawijanie tekstu jest włączone, a wielkość ekranu zmieniana, indeks wiersza może ulec zmianie.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.events.Event; import flash.events.MouseEvent; public class TextField_getLineLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countLines:TextField = new TextField(); public function TextField_getLineLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 350; myTextField.height = 150; myTextField.background = true; myTextField.border = true; myTextField.type = TextFieldType.INPUT; myTextField.appendText("Click on the lines to count its number of characters:\n\n"); myTextField.appendText("This is a short line.\n"); myTextField.appendText("This is a longer line than the last line.\n\n"); myTextField.appendText("This one is even longer than the one before. It has two sentences.\n"); this.addChild(myTextField); countLines.border = true; countLines.x = 10; countLines.y = 180; countLines.height = 30; countLines.width = 200; countLines.background = true; countLines.selectable = false; this.addChild(countLines); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getLineIndexAtPoint(e.localX, e.localY); if (index != -1) { var lenght:int = myTextField.getLineLength(index); countLines.text = "Number of characters in the line is: " + lenght.toString(); } } } }
getLineMetrics | () | metoda |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca informacje o wymiarach danego wiersza tekstu.
Parametry
lineIndex:int — Numer wiersza, którego informacje o wymiarach użytkownik chce uzyskać.
|
flash.text:TextLineMetrics — Obiekt TextLineMetrics.
|
Zgłasza
RangeError — Numer określonego wiersza znajduje się poza obszarem.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Dołączony tekst stanowią dwa wersety utworu Song of Myself Walta Whitmana. Format drugiego wiersza ustawiony zostaje za pomocą nowego obiektu TextFormat (newFormat
). Pierwszy wiersz zachowuje format domyślny. Metoda getLineMetrics()
zwraca obiekt TextLineMetrics
dla konkretnego wiersza. (Indeks wiersza zaczyna się od wartości 0). Za pomocą obiektów TextLineMetrics: metrics1
oraz metrics2
odpowiednio dla pierwszego i drugiego wiersza pobierane oraz wyświetlane są wartości następujących ustawień: wydłużenie górne, wydłużenie dolne, wysokość oraz grubość. Liczby wynikowe są konwertowane na ciągi znaków ale bez zaokrąglenia. Należy pamiętać, że te wartości odnoszą się do wiersza, a nie do konkretnego znaku. Odnoszą się do zakresu znaków w danym wierszu. Jeśli na przykład w wierszu znajdują się znaki o różnych wielkościach, wartość wysokości zostanie określona przez najwyższy znak. Oznacza to również, że jeśli format dowolnego znaku zostanie zmieniony, zmianie mogą ulec również wartości wielkości.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextLineMetrics; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.TextFormat; public class TextField_getLineMetricsExample extends Sprite { public function TextField_getLineMetricsExample() { var myTextField:TextField = new TextField(); var newFormat:TextFormat = new TextFormat(); myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.wordWrap = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("A child said What is the grass? fetching it to me with full hands;\n"); myTextField.appendText("How could I answer the child? I do not know what it is any more than he.\n\n"); newFormat.size = 14; newFormat.font = "Arial"; newFormat.italic = true; myTextField.setTextFormat(newFormat, 67, 139); var metrics1:TextLineMetrics = myTextField.getLineMetrics(0); myTextField.appendText("Metrics ascent for the line 1 is: " + metrics1.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics1.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics1.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics1.width.toString() + "\n\n"); var metrics2:TextLineMetrics = myTextField.getLineMetrics(1); myTextField.appendText("Metrics ascent for the line 2 is: " + metrics2.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics2.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics2.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics2.width.toString() + "\n"); addChild(myTextField); } } }
getLineOffset | () | metoda |
public function getLineOffset(lineIndex:int):int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca indeks pierwszego znaku w wierszu określonego przez parametr lineIndex
.
Parametry
lineIndex:int — Indeks wiersza liczony od 0 (na przykład wartość pierwszego wiersza to 0, drugiego to 1 itd.).
|
int — Indeks pierwszego znaku wiersza, liczony od 0.
|
Zgłasza
RangeError — Numer określonego wiersza znajduje się poza obszarem.
|
Przykład ( Sposób korzystania z tego przykładu )
Pole tekstowe myTextField
jest konfigurowane do zawijania tekstu. Pole tekstowe countField
wyświetli pierwszy znak wiersza o indeksie 4. Kliknięcie pola tekstowego myTextField
wywołuje metodę clickHandler()
.
W metodzie clickHandler()
, metoda getLineOffset()
zwraca indeks pierwszego znaku o wartości indeksu wiersza 3, który należy do czwartego wiersza tekstu. (Wartość indeksu pierwszego wiersza to 0). Za pomocą metody charAt()
można pobrać znak przy użyciu indeksu pierwszego znaku czwartego wiersza. Do zawartości pola tekstowego countField
zostaje dodana ta informacja za pomocą właściwości text
pola tekstowego countField
. Korzystanie z właściwości countField.text
oznacza, że po każdym kliknięciu zawartości pola tekstowego countField
zostanie ono nadpisane. Jeśli użytkownik dokona zmiany wielkości wyświetlanego tekstu, zawartość będzie zawijana, a pierwszy znak czwartego wiersza może się zmienić. Po ponownym kliknięciu pola myTextField
, zawartość pola tekstowego countField
zostaje zaktualizowana i obejmuje nowy pierwszy znak czwartego wiersza.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getLineOffsetExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getLineOffsetExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 150; myTextField.height = 300; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; countField.height = 20; countField.width = 200; countField.x = 10; countField.y = 320; countField.selectable = false; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var c:String; var index:int; index = myTextField.getLineOffset(3); c = myTextField.text.charAt(index); countField.text = "The first character of line 4 is: " + c; } } }
getLineText | () | metoda |
public function getLineText(lineIndex:int):String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca wiersz tekstowy określony przez parametr lineIndex
.
Parametry
lineIndex:int — Indeks wiersza liczony od 0 (na przykład wartość pierwszego wiersza to 0, drugiego to 1, itd.).
|
String — Ciąg znaków zawarty w określonym wierszu.
|
Zgłasza
RangeError — Numer określonego wiersza znajduje się poza obszarem.
|
Przykład ( Sposób korzystania z tego przykładu )
Dla pola tekstowego poem
zastosowano ustawienia automatycznego dopasowania oraz wyrównania tekstu do lewej strony. Ponieważ właściwość wordWrap
jest ustawiona na wartość false
, dlatego wersety wiersza nie będą zawijane, choć w standardowym zastosowaniu właściwości autoSize
nie byłoby to problemem. Pętla for
jest iterowana przez wersety sonetu za pomocą właściwości numLines
pola tekstowego. MetodagetLineText()
zwraca zawartość wiersza w formie ciągu znaków. (Należy pamiętać, że właściwość numLines
zwraca numer wiersza zaczynając od wartości 1, podczas gdy dla metody getLineText()
numer początkowego wiersza to 0). Przy użyciu wzorca regularnego wyrażenia (/love/i
) instrukcja warunkowa if
przeszukuje każdy ciąg cząstkowy wyrazu niezależnie od wielkości liter. Jeśli wzorzec zostanie znaleziony, metoda search
zwraca indeks pierwszego pasującego ciągu cząstkowego, a w sytuacji przeciwnej — zwraca wartość -1
(jeśli nie znajdzie zgodnego ciągu). Numer wiersza, w którym znaleziono słowo „love” ((i + 1)
) zostaje umieszczony w ciągu znaków lineResult
. Metoda ciągu znaków konwertuje argument numeru ((i + 1)
) na ciąg znaków, o ile istnieje inny argument będący ciągiem znaków („ ”). Wynik szukania wiersza będzie obejmował wiersze zawierające słowo „loved” czy „Love's”. Jeśli ciąg znaków „Love was found in lines:” zostanie umieszczony przed pętlą for
, słowo „Love” w tym wierszu również zostanie ujęte.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.utils.Timer; import flash.events.TimerEvent; public class TextField_getLineTextExample extends Sprite { public function TextField_getLineTextExample() { var poem:TextField = new TextField(); var lineResult:String = ""; var pattern:RegExp = /love/i; poem.x = 10; poem.y = 10; poem.background = true; poem.wordWrap = false; poem.autoSize = TextFieldAutoSize.LEFT; poem.text = "Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved.\n\n"; for (var i:int = 0; i < poem.numLines; i++) { var s:String = poem.getLineText(i); if(s.search(pattern) != -1) { lineResult += (i + 1) + " "; } } poem.appendText("Love was found in lines: " + lineResult); this.addChild(poem); } } }
getParagraphLength | () | metoda |
public function getParagraphLength(charIndex:int):int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Po podaniu indeksu znaku zwraca wartość długości akapitu zawierający dany znak. Długość jest obliczana w odniesieniu do pierwszego znaku w akapicie (zwróconego przez metodę getFirstCharInParagraph()
), a nie znaku, którego indeks został podany.
Parametry
charIndex:int — Indeks znaku liczony od 0 (na przykład pierwszy znak to 0, drugi to 1, itd.).
|
int — Zwraca liczbę znaków w akapicie.
|
Zgłasza
RangeError — Określony indeks znaków jest poza zakresem.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Pole tekstowe myTextField
wyświetla akapity, które zaznaczy użytkownik. Kliknięcie na pole tekstowe wywoła zdarzenie MouseEvent.CLICK
i wywoła metodę clickHandler()
. Wartości dla długości akapitu oraz liczby wystąpień znaku „s” pojawią się w polu tekstowym countField
, które znajduje się poniżej pola tekstowego myTextField
.
W metodzie clickHandler()
, metoda getCharIndexAtPoint()
zwraca indeks znaku w oparciu o współrzędne localX
oraz localY
punktu kliknięcia myszą. Pierwsza instrukcja if
sprawdza, czy został kliknięty znak. Na podstawie tego indeksu metoda getFirstCharInParagraph()
zwraca indeks pierwszego znaku w tym samym akapicie. Wartość długości akapitu zwrócona przez metodę getParagraphLength()
wraz z indeksem pierwszego znaku w akapicie służy do określenia indeksu końca akapitu. Pętla for
jest iterowana przez akapit w poszukiwaniu liczby znaków „s”.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getParagraphLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getParagraphLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 280; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField() constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); countField.x = 10; countField.y = 300; countField.height = 50; countField.width = 250; countField.background = true; countField.selectable = false; this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(index != -1) { var beginParag:int = myTextField.getFirstCharInParagraph(index); var paragLength:int = myTextField.getParagraphLength(index); var endParag:int = beginParag + paragLength; var sCount:uint = 0; for (var i:int = beginParag; i <= endParag; i++) { if ((myTextField.text.charAt(i) == "s") || (myTextField.text.charAt(i) == "S")) { sCount++; } countField.text = "Paragraph length is: " + paragLength.toString() + "\n" + "Number of 's' characters in the paragraph: " + sCount.toString(); } } } } }
getTextFormat | () | metoda |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca obiekt TextFormat zawierający informacje o formatowaniu dla zakresu tekstu określonego przez parametry beginIndex
oraz endIndex
. Tylko właściwości wspólne dla całego danego tekstu zostają zawarte w wynikowym obiekcie TextFormat. Dowolna właściwość, która jest mieszana (co oznacza że przyjmuje różne wartości dla różnych punktów tekstu) ma wartość null
.
Jeśli wartości dla tych parametrów nie zostaną określone, ta metoda zostanie zastosowana do całego tekstu w polu tekstowym.
Poniższa tabela przedstawia trzy możliwe zastosowania:
Zastosowanie | Opis |
---|---|
my_textField.getTextFormat() | Zwraca obiekt TextFormat zawierający informacje o formatowaniu dla całego tekstu z polu tekstowym. W wynikowym obiekcie TextFormat ustawiane są tyko te właściwości, które są wspólne dla całego tekstu w polu tekstowym. Dowolna właściwość, która jest mieszana (co oznacza, że przyjmuje różne wartości dla różnych punktów tekstu) ma wartość null . |
my_textField.getTextFormat(beginIndex:Number) | Zwraca obiekt zawierający kopię formatu tekstowego znaku znajdującego się w pozycji beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Zwraca obiekt TextFormat zawierający informacje o formatowaniu dla zakresu formatowania tekstowego od wartościbeginIndex do endIndex-1 . W wynikowym obiekcie TextFormat ustawiane są tylko te właściwości, które są wspólne dla całego tekstu w określonym zakresie. Dowolna właściwość, która jest mieszana (co oznacza, że przyjmuje różne wartości dla różnych punktów zakresu) ma wartość null . |
Parametry
beginIndex:int (default = -1 ) — Opcjonalnie; liczba całkowita określająca początek zakresu tekstu w polu tekstowym.
| |
endIndex:int (default = -1 ) — Opcjonalnie; liczba całkowita określająca położenie pierwszego znaku po żądanym zakresie tekstu. Zgodnie oczekiwaniami określenie wartości beginIndex i endIndex powoduje odczytanie tekstu z zakresu od beginIndex do endIndex-1 .
|
flash.text:TextFormat — Obiekt TextFormat, który reprezentuje właściwości formatowania danego tekstu.
|
Zgłasza
RangeError — Podany parametr beginIndex lub endIndex znajduje się poza zakresem.
|
Powiązane elementy interfejsu API
Przykład
Sposób korzystania z tego przykładu
Sposób wykorzystania metody getTextFormat() ilustrują przykłady dla metod getFirstCharInParagraph() oraz
setTextFormat()
.
isFontCompatible | () | metoda |
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Zwraca wartość true, jeśli osadzona czcionka jest dostępna z określonymi parametrami fontName
i fontStyle
, gdzie Font.fontType
ma wartość flash.text.FontType.EMBEDDED
. Począwszy od wersji Flash Player 10 w plikach SWF mogą być stosowane dwa rodzaje osadzonych czcionek. Normalne czcionki osadzone są używane tylko z obiektami TextField. Osadzone czcionki CFF są używane tylko z klasami flash.text.engine. Te dwa typy odróżnia właściwość fontType
klasy Font
, jaka jest zwracana przez funkcję enumerateFonts()
.
Obiekt TextField nie może korzystać z czcionki typu EMBEDDED_CFF
. Jeśli dla parametru embedFonts
ustawiona jest wartość true
, a jedyna czcionka o określonej nazwie i stylu, jaka jest dostępna w środowisku wykonawczym, jest typu EMBEDDED_CFF
, program Flash Player nie przeprowadzi renderowania tekstu — tak, jakby żadna osadzona czcionka nie była dostępna z określoną nazwą i stylem.
Jeśli czcionki EMBEDDED
i EMBEDDED_CFF
są dostępne (o takiej samej nazwie i stylu), zostaje wybrana czcionka EMBEDDED
i wówczas tekst jest renderowany z czcionką EMBEDDED
.
Parametry
fontName:String — Nazwa osadzonej czcionki do sprawdzenia.
| |
fontStyle:String — Określa styl czcionki do sprawdzenia. Należy użyć flash.text.FontStyle
|
Boolean — true , jeśli dostępna jest zgodna czcionka osadzona, w przeciwnym wypadku false .
|
Zgłasza
ArgumentError — Określony obiekt fontStyle nie jest elementem flash.text.FontStyle .
|
Powiązane elementy interfejsu API
replaceSelectedText | () | metoda |
public function replaceSelectedText(value:String):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zastępuje bieżące zaznaczenie zawartością parametru value
. Tekst zostaje wstawiony w miejscu bieżącego zaznaczenia wraz z domyślnym formatem znaków i akapitu. Tekst nie jest traktowany jako tekst HTML.
Metodę replaceSelectedText()
można użyć do stawiania lub i usuwania tekstu, nie powodując zmian w formatowaniu znaków i akapitu w pozostałej części tekstu.
Uwaga: jeśli do pola tekstowego zastosowano arkusz stylów, ta metoda nie będzie działać.
Parametry
value:String — Ciąg znaków, który zastępuje aktualnie zaznaczony tekst.
|
Zgłasza
Error — Tej metody nie można stosować do pola tekstowego zawierającego arkusz stylów.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Dla zdarzeń MouseEvent.MOUSE_UP
tworzone są dwa różne obiekty TextField oraz dodawane detektory zdarzeń. Zdarzenie Mouse up zostaje wywołane w momencie, gdy użytkownik zwalnia przycisk myszy (zdarzenie, które zwykle ma miejsce po zaznaczeniu fragmentu tekstu). Należy pamiętać o wybraniu domyślnych ustawień dla tekstu w polu tekstowym.
Zwolnienie przycisku myszy w polu tekstowym myTextField1
, przy zastosowaniu metody mouseHandler1()
, powoduje wymazanie tekstu i zastąpienie go pustym ciągiem znaków. W ten sposób można wymazać cały tekst. Zaznaczenie fragmentu tekstu w polu tekstowym myTextField2
, przy użyciu metody mouseHandler2()
, powoduje sprawdzenie właściwości selectionBeginIndex
oraz selectionEndIndex
pod kątem zaznaczenia znaku. (Właściwości selectionBeginIndex
oraz selectionEndIndex
nie będą posiadały tych samych wartości, jeśli dowolny fragment tekstu został zaznaczony). Zaznaczony tekst zostaje następnie zastąpiony ciągiem znaków „NEW TEXT”. W ten sposób można zastąpić cały pierwotny tekst drugiego pola tekstowego ciągiem znaków „NEW TEXT”.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_replaceSelectedTextExample extends Sprite { private var myTextField1:TextField = new TextField(); private var myTextField2:TextField = new TextField(); public function TextField_replaceSelectedTextExample() { myTextField1.x = 10; myTextField1.width = 300; myTextField1.height = 50; myTextField1.background = true; myTextField1.border = true; myTextField1.text = "Select the text you want to remove from the line."; myTextField2.x = 10; myTextField2.y = 60; myTextField2.width = 300; myTextField2.height = 50; myTextField2.background = true; myTextField2.border = true; myTextField2.text = "Select the text you want to replace with NEW TEXT."; myTextField1.addEventListener(MouseEvent.MOUSE_UP, mouseHandler1); myTextField2.addEventListener(MouseEvent.MOUSE_UP, mouseHandler2); this.addChild(myTextField1); this.addChild(myTextField2); } private function mouseHandler1(e:MouseEvent):void { myTextField1.replaceSelectedText(""); } private function mouseHandler2(e:MouseEvent):void { if(myTextField2.selectionBeginIndex != myTextField2.selectionEndIndex) { myTextField2.replaceSelectedText("NEW TEXT"); } } } }
replaceText | () | metoda |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zastępuje zakres znaków określonych przez parametry beginIndex
oraz endIndex
zawartością parametru newText
. Zgodnie z planem został zastąpiony tekst z zakresu od beginIndex
do endIndex-1
.
Uwaga: Jeśli do pola tekstowego zastosowano arkusz stylów, ta metoda nie będzie działać.
Parametry
beginIndex:int — Liczony od 0 indeks pozycji wyjściowej zakresu zamiennego.
| |
endIndex:int — Liczony od 0 indeks pozycji pierwszego znaku po żądanym zakresie tekstu.
| |
newText:String — Tekst, który zastąpi określony zakres znaków.
|
Zgłasza
Error — Tej metody nie można stosować do pola tekstowego zawierającego arkusz stylów.
|
Przykład ( Sposób korzystania z tego przykładu )
replaceText()
do usuwania, zastępowania oraz umieszczania fragmentów tekstu w polu tekstowym.
Ustawienie pola tekstowego outputText
powoduje automatyczne dopasowanie tekstu i jego wyrównanie do lewej strony. Pierwsze wywołanie metody replaceText()
powoduje zastąpienie pierwszego wiersza („This is the wrong heading”) tekstem „THIS IS THE HEADING FOR EVERYONE”. Drugie wywołanie metody powoduje umieszczenie tekstu „CORRECT” między wyrazami „THE” i „HEADING”. Wywołanie metody po raz trzeci spowoduje usunięcie wyrazów „FOR EVERYONE”. Dla każdego wywołania metody appendText()
wartości bieżącego indeksu początku i końca tekstu zmieniają się. Tutaj zostanie wyświetlona ostateczna wersja tekstu (po dokonaniu wszystkich zmian).
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_replaceTextExample extends Sprite { public function TextField_replaceTextExample() { var outputText:TextField = new TextField(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.appendText("This is the wrong heading"); outputText.appendText("\n\n"); outputText.appendText("This is the body of the text."); outputText.replaceText(0, 25, "THIS IS THE HEADING FOR EVERYONE"); outputText.replaceText(12, 12, "CORRECT "); outputText.replaceText(27, 40, ""); this.addChild(outputText); } } }
setSelection | () | metoda |
public function setSelection(beginIndex:int, endIndex:int):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zaznacza tekst określony wartościami indeksu pierwszego i ostatniego znaku, podanymi w parametrach beginIndex
oraz endIndex
. Jeśli wartości tych dwóch parametrów są takie same, za pomocą tej metody wyznacza się punkt wstawiania w taki sposób, jakby właściwość caretIndex
została ustawiona.
Parametry
beginIndex:int — Indeks pierwszego znaku w zaznaczonym fragmencie, liczony od 0 (na przykład pierwszy znak określa wartości 0, drugi wartość 1, itd.).
| |
endIndex:int — Indeks ostatniego znaku zaznaczenia, liczony od 0.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Zdarzenia spowodowane kliknięciem myszą lub zwolnieniem przycisku myszy zostaną odnotowane przez dwa detektory zdarzeń pola tekstowego myTextField
. Zdarzenie Mouse up zostanie wywołane, gdy użytkownik zwolni przycisk myszy (zdarzenie, które zwykle ma miejsce po zaznaczeniu fragmentu tekstu. Należy pamiętać o wybraniu domyślnego ustawienia dla tekstu w polu tekstowym. Kliknięcie fragmentu tekstu spowoduje wywołanie metody clickHandler()
. Metoda mouseUpHandler()
zostaje wywołana po zaznaczeniu tekstu i zwolnieniu przycisku myszy.
Dla obydwu metod clickHandler()
i mouseUpHandler()
metoda setSelection()
określa tylko znaki między indeksami 54 a 70 (TEXT IN ALL CAPS), które powinny być zaznaczone.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_setSelectionExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_setSelectionExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS is selected."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); myTextField.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } private function mouseUpHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } } }
setTextFormat | () | metoda |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Stosuje formatowanie tekstowe określone przez parametr format
do danego tekstu w polu tekstowym. Wartością parametru format
musi być obiekt TextFormat, który określa żądane zmiany formatowania tekstowego. Tylko właściwości format
różne od wartości null są stosowane do pola tekstowego. Żadna właściwość format
ustawiona na wartość null
nie jest stosowana. Wszystkie właściwości nowo utworzonego obiektu TextFormat są domyślnie ustawione na wartość null
.
Uwaga: jeśli do pola tekstowego zastosowano arkusz stylów, ta metoda nie będzie działać.
Za pomocą metody setTextFormat()
można zmienić formatowanie tekstowe zastosowane do zakresu znaków lub całego tekstu w polu tekstowym. Aby zastosować właściwości formatu do całego tekstu w polu tekstowym, nie należy określać wartości dla parametrów beginIndex
oraz endIndex
. Aby zastosować właściwości formatu do zakresu tekstu, należy określić wartości dla parametrów beginIndex
i endIndex
. Właściwość length
umożliwia zdefiniowanie wartości indeksów.
Dwa rodzaje informacji znajdujących się w obiekcie TextFormat to poziom formatowania znaków oraz poziom formatowania akapitu. Każdy znak w polu tekstowym może posiadać indywidualne ustawienia formatowania, takie jak nazwa czcionki, jej rozmiar, pogrubienie oraz kursywa.
W przypadku akapitów pierwszy znak akapitu jest analizowany pod kątem ustawień formatowania akapitu dla całego akapitu. Przykłady ustawień formatowania akapitu stanowią: lewy margines, prawy margines oraz wcięcie.
Dowolny fragment tekstu wstawiony przez użytkownika lub zastąpiony przy użyciu metody replaceSelectedText()
zostanie poddany domyślnemu formatowaniu pola tekstowego dla nowego tekstu, a nie formatowaniu ustawionemu dla miejsca wstawienia tekstu. Aby ustawić domyślne formatowanie pola tekstowego dla nowego tekstu, należy użyć właściwości defaultTextFormat
.
Parametry
format:flash.text:TextFormat — Obiekt TextFormat zawierający informacje o formatowaniu znaków i akapitu.
| |||||||||
beginIndex:int (default = -1 ) — Opcjonalnie; liczba całkowita, która definiuje pozycję indeksu określającą pierwszy znak lub żądany zakres tekstu.
| |||||||||
endIndex:int (default = -1 ) — Opcjonalnie; liczba całkowita, która określa pierwszy znak po żądanym zakresie tekstu. Zgodnie z planem określenie wartości beginIndex oraz endIndex spowoduje aktualizację tekstu z zakresu od beginIndex do endIndex-1 .
Należy pamiętać, że dowolny fragment tekstu wstawiony przez użytkownika lub zastąpiony przy użyciu metody |
Zgłasza
Error — Tej metody nie można stosować do pola tekstowego zawierającego arkusz stylów.
| |
RangeError — Podany parametr beginIndex lub endIndex znajduje się poza zakresem.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Dla pola tekstowego myTextField
zostaje dodany detektor zdarzeń, który na kliknięcia myszą będzie reagował wywołaniem metody clickHandler()
. W metodzie clickHandler()
metoda getTextFormat()
zwraca bieżący format znaku (indeks 55) z danego zakresu tekstu, który zostaje następnie umieszczany we właściwości currentTextFormat
obiektu TextFormat. Instrukcja warunkowa if
sprawdza czy we właściwość currentTextFormat
została zastosowana jako nowy format do znaku z zakresu (wielkość czcionki ustawiona na 18 punktów). Jeśli nie, nowy format zmienia rozmiar czcionki na 18 punktów, kolor na czerwony, dodaje podkreślenie oraz kursywę do zakresu tekstu między wartościami 54-70 („TEXT IN ALL CAPS”). Jeśli znak z zakresu jest w nowym formacie, format zakresu zostaje z powrotem ustawiony na domyślny (pierwotny) format pola tekstowego.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.events.MouseEvent; public class TextField_setTextFormatExample extends Sprite { private var myTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_setTextFormatExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.selectable = false; myTextField.background = true; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS changes format."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); newFormat.color = 0xFF0000; newFormat.size = 18; newFormat.underline = true; newFormat.italic = true; this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { var currentTextFormat:TextFormat = myTextField.getTextFormat(55); if(currentTextFormat.size != 18) { myTextField.setTextFormat(newFormat, 54, 70); } else { myTextField.setTextFormat(myTextField.defaultTextFormat); } } } }
change | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.CHANGE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane po zmodyfikowaniu wartości kontrolnej — inaczej niż zdarzenie textInput
, które jest wywoływane przed modyfikacją wartości. Inaczej niż w wersji zdarzenia change
obowiązującej w modelu W3C DOM Event Model, gdzie zdarzenie wywoływane jest wyłącznie po utracie aktywności przez element sterujący, w języku ActionScript 3.0 zdarzenie change
jest wywoływane po każdej zmianie elementu sterującego. Na przykład, jeśli użytkownik wpisuje tekst do pola tekstowego, zdarzenie change
zostaje wywołane za każdym uderzeniem klawisza.
Event.CHANGE
definiuje wartość właściwości type
obiektu zdarzenia change
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Wartość obiektu została zmodyfikowana. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
Przykład ( Sposób korzystania z tego przykładu )
Tworzone są dwa pola tekstowe: jedno dla danych wprowadzanych przez użytkownika oraz drugie (headingTextField
) dla kopiowania tych danych. Utworzony również zostaje obiekt TextFormat, a do pola tekstowego headingTextField
zostaje przypisany domyślny format tekstowy. Zmiana zawartości pola tekstowego wywołuje metodę changeHandler()
, która przypisuje tekst w polu tekstowym inputTextField
do pola tekstowego headingTextField
. (Jeśli metoda zostałaby wywołana dla zdarzenia TextEvent.TEXT_INPUT
zamiast Event.CHANGE
, zawartość danych wpisanych przez użytkownika zostałaby skopiowana dopiero podczas wprowadzenia kolejnego fragmentu tekstu przez użytkownika).
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; import flash.text.TextFormatAlign; import flash.events.Event; import flash.events.TextEvent; public class TextField_Event_changeExample extends Sprite { private var inputTextField:TextField = new TextField(); private var headingTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_Event_changeExample() { headingTextField.x = 10; headingTextField.y = 10; headingTextField.height = 30; headingTextField.width = 400; headingTextField.background = true; headingTextField.backgroundColor = 0xF5F5DC; headingTextField.selectable = false; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 230; inputTextField.background = true; inputTextField.border = true; inputTextField.maxChars = 40; inputTextField.wordWrap = true; inputTextField.type = TextFieldType.INPUT; inputTextField.addEventListener(Event.CHANGE, changeHandler); newFormat.bold = true; newFormat.size = 18; newFormat.color = 0xFF0000; newFormat.align = TextFormatAlign.CENTER; headingTextField.defaultTextFormat = newFormat; this.addChild(inputTextField); this.addChild(headingTextField); } private function changeHandler(e:Event):void { headingTextField.text = inputTextField.text; } } }
link | Zdarzenie |
flash.events.TextEvent
właściwość TextEvent.type =
flash.events.TextEvent.LINK
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik klika hiperłącze w polu tekstowym HTML, którego adres URL zaczyna się od ciągu „event:”. Pozostały fragment adresu URL znajdujący się po fragmencie „event:” zostanie umieszczony we właściwościach tekstu zdarzenia LINK.
Uwaga: Domyślne zachowanie, dodawanie tekstu do pola tekstu, następuje wówczas, gdy program Flash Player wywoła zdarzenie, które w tym przypadku ma miejsce w momencie, gdy użytkownik próbuje wprowadzić tekst. Nie można dodać tekstu do pola tekstowego za pomocą zdarzenia textInput
.
type
obiektu zdarzenia link
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Pole tekstowe zawierające kliknięte hiperłącze. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
text | Pozostała część adresu URL po ciągu "event:". |
Przykład ( Sposób korzystania z tego przykładu )
playMP3()
. Utworzony zostaje obiekt TextField o nazwie list
, zapełniany następnie tekstem HTML. Tekst "Track 1"
i "Track 2"
stanowi łącza wewnątrz pola tekstowego. Kliknięcie któregokolwiek z nich wywołuje funkcję playMP3(). Nazwa pliku MP3, która następuje po ciągu znaków „zdarzenie:" w atrybucie href
znacznika HTML zostaje przekazana do metody linkHandler()
jako właściwość text
obiektu zdarzenia link
.
package { import flash.display.Sprite; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.events.TextEvent; import flash.media.Sound; import flash.media.SoundChannel; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_event_link extends Sprite { private var myMP3:Sound; public function TextField_event_link() { myMP3 = new Sound(); var list:TextField = new TextField(); list.autoSize = TextFieldAutoSize.LEFT; list.multiline = true; list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>"; list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>"; addEventListener(TextEvent.LINK, linkHandler); addChild(list); } private function playMP3(mp3:String):void { try { myMP3.load(new URLRequest(mp3)); myMP3.play(); } catch(err:Error) { trace(err.message); } myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); } private function linkHandler(linkEvent:TextEvent):void { playMP3(linkEvent.text); } private function errorHandler(errorEvent:IOErrorEvent):void { trace(errorEvent.text); } } }
scroll | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.SCROLL
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane przez obiekt TextField po tym jak użytkownik przewinął tekst.
StałaEvent.SCROLL
definiuje wartość właściwości type
obiektu zdarzeniascroll
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt TextField, który został przewinięty. Właściwość target nie zawsze jest obiektem na liście wyświetlania, który zarejestrował detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
Przykład ( Sposób korzystania z tego przykładu )
mouseDown
oraz skojarzonego z nim modułu obsługi zdarzeń mouseDownScroll
. Moduł obsługi zdarzeń mouseDownScroll()
powoduje przewinięcie pola. Następnie wywoływane jest zdarzenie scroll
, a skojarzony z nim moduł scrollHandler()
aktualizuje drugie pole tekstowe tak, aby wyświetlana w nim był obecny status przewijania.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextScrollExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); private var myText:String = "Hello world and welcome to the show. It's really nice to meet you. Take your coat off and stay a while. OK, show is over. Hope you had fun. You can go home now. Don't forget to tip your waiter. There are mints in the bowl by the door. Thank you. Please come again."; public function TextScrollExample() { myTextBox1.text = myText; myTextBox1.width = 200; myTextBox1.height = 50; myTextBox1.multiline = true; myTextBox1.wordWrap = true; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownScroll); myTextBox1.addEventListener(Event.SCROLL, scrollHandler); } public function mouseDownScroll(event:MouseEvent):void { myTextBox1.scrollV++; } public function scrollHandler(event:Event):void { myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; } } }
textInput | Zdarzenie |
flash.events.TextEvent
właściwość TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Program Flash Player wywołuje zdarzenie textInput
, kiedy użytkownik wprowadzi co najmniej jeden znak. To zdarzenie można wygenerować przy użyciu wielu różnych metod wprowadzania tekstu, w tym za pomocą standardowych klawiatur, edytora IME, systemów rozpoznawania głosu i mowy, a nawet poprzez wklejenie zwykłego tekstu, który nie będzie zawierał żadnych danych dotyczących formatowania czy stylu.
type
obiektu zdarzenia textInput
.
Uwaga: To zdarzenie nie jest wywoływane dla klawiszy Delete ani Backspace.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | true ; w celu anulowania zachowania domyślnego należy wywołać metodę preventDefault() . |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Pole tekstowe, do którego wprowadzane są znaki. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
text | Znak lub sekwencja znaków wprowadzonych przez użytkownika. |
Przykład ( Sposób korzystania z tego przykładu )
textInput
, a następnie moduł obsługi zdarzeń textInputHandler()
i znaki zostają wyświetlone w drugim polu tekstowym. W przypadku wklejania bloku tekstowego do pola wprowadzania moduł obsługi zdarzeń kopiuje cały blok do drugiego z pól.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextInputExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); public function TextInputExample() { myTextBox1.type = TextFieldType.INPUT; myTextBox1.width = 200; myTextBox1.height = 20; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(TextEvent.TEXT_INPUT,textInputHandler); } public function textInputHandler(event:TextEvent):void { myTextBox2.text=event.text; } } }
textInteractionModeChange | Zdarzenie |
flash.events.Event
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Program Flash Player wywołuje zdarzenie textInteractionModeChange
, gdy użytkownik zmienia tryb interakcji pola tekstowego. W systemie Android można na przykład przełączać między trybem NORMAL (normalny) a trybem SELECTION (zaznaczanie) za pomocą opcji menu kontekstowego.
TextFieldExample
. Należy wykonać następujące czynności:
- Utworzona zostaje właściwość
label
typu TextField. - Konstruktor klasy wywołuje funkcję
configureLabel()
. - Metoda
configureLabel()
tworzy najpierw nowy obiekt TextField i przypisuje go do właściwościlabel
, a następnie ustawia jego właściwości w następujący sposób:- Wyrównaj pole tekstowe do lewej.
- Włącz wypełnianie tła.
- Włącz obramowanie.
- Metoda
configureLabel()
tworzy zmiennąformat
i przypisuje są do nowej instancji TextFormat wraz z parametrami ustawionymi w następujący sposób:- Typ czcionki = Verdana
- Kolor czcionki = czerwony kryjący
- Rozmiar czcionki = 10
- Podkreślenie = true
- Właściwość
defaultTextFormat
pola tekstowegolabel
jest również ustawiona wgformatu
, a instancjalabel
zostaje dodana do listy wyświetlania, która na stole montażowym wyświetla początkowo pole tekstowe bez tekstu. - Konstruktor zmienia tekst pola tekstowego
label
na„Hello world and welcome to the show”.
przez wywołanie metodysetLabel()
.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.TextFormat; public class TextFieldExample extends Sprite { private var label:TextField; private var labelText:String = "Hello world and welcome to the show."; public function TextFieldExample() { configureLabel(); setLabel(labelText); } public function setLabel(str:String):void { label.text = str; } private function configureLabel():void { label = new TextField(); label.autoSize = TextFieldAutoSize.LEFT; label.background = true; label.border = true; var format:TextFormat = new TextFormat(); format.font = "Verdana"; format.color = 0xFF0000; format.size = 10; format.underline = true; label.defaultTextFormat = format; addChild(label); } } }
Tue Jun 12 2018, 12:06 PM Z