IUITextField  - AS3 Flex

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.

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:

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.

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.

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.

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.

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.

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.

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.).

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.

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.

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.

Określa, czy obiekt otrzymuje zdarzenia doubleClick. Domyślna wartość to false co oznacza, iż domyślnie instancja InteractiveObject nie otrzymuje zdarzeń doubleClick. Jeżeli właściwość doubleClickEnabled jest ustawiona na wartość true, wówczas instancja otrzymuje zdarzenia doubleClick wewnątrz swoich granic. Właściwość mouseEnabled instancji InteractiveObject również musi być ustawiona na wartość true, aby obiekt mógł otrzymywać zdarzenia doubleClick.

Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu dodania detektora zdarzeń dla zdarzenia doubleClick.

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.

Określa, czy z tym obiektem skojarzono ramkę aktywności. Może mieć jedną z trzech wartości: true, false lub null. Wartości true i false działają zgodnie z oczekiwaniami; określają one, czy pojawia się prostokąt oznaczający aktywność obiektu. Wartość null oznacza, że ten obiekt jest zgodny z właściwością stageFocusRect stołu montażowego.

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:

Zawiera reprezentację zawartości pola tekstowego w formacie HTML.

Program Flash Player obsługuje następujące znaczniki HTML:

Program Flash Player i środowisko AIR obsługują następujące elementy HTML:

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).

If true, the paddingLeft and paddingRight styles will not add space around the text of the component.

The beginning of this UITextField's chain of inheriting styles. The getStyle() method accesses inheritingStyles[styleName] to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

Liczba znaków w polu tekstowym. Znaczniki (\t) są liczone jako pojedyncze znaki.

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.

Maksymalna wartość właściwości scrollH.

Maksymalna wartość właściwości scrollV.

Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. Domyślna wartość to true, co oznacza, że domyślnie każda instancja klasy InteractiveObject znajdująca się na liście wyświetlania odbiera zdarzenia myszy lub innego urządzenia wejściowego. Jeśli dla właściwości mouseEnabled jest ustawiona wartość false, wystąpienie nie odbiera zdarzeń myszy (ani innych zdarzeń związanych z interakcją ze strony użytkownika, na przykład zdarzeń klawiatury). Nie ma to wypływu na żaden z obiektów podrzędnych instancji z listy wyświetlania. W celu zmiany zachowania mouseEnabled dla wszystkich obiektów podrzędnych z listy wyświetlania należy zastosować funkcję flash.display.DisplayObjectContainer.mouseChildren.

Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu utworzenia interaktywnej funkcjonalności.

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.

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.

Depth of this object in the containment hierarchy. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.

The beginning of this UITextField's chain of non-inheriting styles. The getStyle() method accesses nonInheritingStyles[styleName] method to search the entire prototype-linked chain. This object is set up by the initProtoChain() method. You typically never need to access this property directly.

Unlike textHeight, this returns a non-zero value even when the text is empty. In this case, it returns what the textHeight would be if the text weren't empty.

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ę.

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";
     

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.

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.

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.

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.

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.

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).

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.

Określa, czy ten obiekt można osiągnąć za pomocą klawisza Tab. Wartość true, jeżeli obiekt ten można osiągnąć za pomocą klawisza Tab; w innym przypadku wartość false. Domyślnie wartość to false, z wyjątkiem sytuacji wymienionych poniżej:

• Wartość true dla obiektu SimpleButton.
• Wartość true dla obiektu TextField z właściwością type = "input".
• Wartość true dla obiektu Sprite lub obiektu MovieClip z właściwością buttonMode = true.

Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. Właściwość tabIndex ma domyślnie wartość -1, co oznacza iż nie jest ustawiony indeks tabulacji dla tego obiektu.

Jeżeli dowolny z obecnie wyświetlanych obiektów w pliku SWF zawiera właściwość tabIndex, wówczas automatyczna kolejność uaktywniania dla klawisza Tab jest wyłączone, zaś kolejność jest określana przez właściwości tabIndex obiektów w pliku SWF. Do własnej kolejności uaktywniania dla klawisza Tab można włączyć tylko obiekty posiadające właściwości tabIndex.

Wartością właściwości tabIndex może być nie ujemna liczba całkowita. Obiekty są porządkowane zgodnie z właściwościami tabIndex w kolejności rosnącej. Obiekt z wartością właściwości tabIndex równą 1 ma pierwszeństwo względem obiektu z wartością właściwości tabIndex równą 2. Nie należy używać tej samej wartości tabIndex dla wielu obiektów.

Własna kolejność uaktywniania definiowana przez właściwość tabIndex to flat. Oznacza to, iż nie zwraca się uwagi na stosunki hierarchiczne obiektów w pliku SWF. Wszystkie obiekty w pliku SWF z właściwościami tabIndex są układane zgodnie z kolejnością aktywacji klawiszem Tab, która jest określane przez wartości właściwości tabIndex.

Uwaga: Aby ustawić kolejność aktywacji klawiszem Tab dla instancji TLFTextField, należy wykonać rzutowanie obiektu podrzędnego obiektu wyświetlanego TLFTextField na klasę InteractiveObject, a następnie ustawić właściwość tabIndex. Na przykład:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

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.

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.

Wysokość tekstu w pikselach.

Szerokość tekstu w pikselach.

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).

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ć.

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.

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.

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

Zwraca prostokąt będący obwiednią znaku.

Parametry

Zwraca indeks znaku liczony od 0 w punkcie określonym parametrami x i y.

Parametry

Po otrzymaniu indeksu znaku zwraca indeks pierwszego znaku w tym samym akapicie.

Parametry

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

Zwraca liczony od 0 indeks wiersza o podanym położeniu określonym przez parametry x i y.

Parametry

Zwraca liczony od 0 indeks wiersza zawierającego znak określony przez parametr charIndex.

Parametry

Zwraca liczbę znaków w określonym wierszu tekstowym.

Parametry

Zwraca informacje o wymiarach danego wiersza tekstu.

Parametry

Zwraca indeks pierwszego znaku w wierszu określonego przez parametr lineIndex.

Parametry

Zwraca wiersz tekstowy określony przez parametr lineIndex.

Parametry

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

Gets a style property that has been set anywhere in this component's style lookup chain.

This same method is used to get any kind of style property, so the value returned can be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is simply specified as *.

If you are getting a particular style property, you know its type and often want to store the result in a variable of that type. No casting from * to that type is necessary.

var backgroundColor:uint = getStyle("backgroundColor");

If the style property has not been set anywhere in the style lookup chain, the value returned by getStyle() is undefined. Note that undefined is a special value that is not the same as false, "", NaN, 0, or null. No valid style value is ever undefined. You can use the method IStyleManager2.isValidStyleValue() to test whether the value was set.

Parametry

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:

Parametry

Returns a UITextFormat object that contains formatting information for this component. This method is similar to the getTextFormat() method of the flash.text.TextField class, but it returns a UITextFormat object instead of a TextFormat object.

The UITextFormat class extends the TextFormat class to add the text measurement methods measureText() and measureHTMLText().

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

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

Sets the font color of the text.

Parametry

Sets the focus to this component. The component can in turn pass focus to a subcomponent.

Note: Only the TextInput and TextArea controls show a highlight when this method sets the focus. All controls show a highlight when the user tabs to the control.

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