| Pakiet | mx.core |
| Interfejs | public interface IUITextField extends IIMESupport , IFlexModule , IInvalidating , ISimpleStyleClient , IToolTipManagerClient , IUIComponent , IFlexDisplayObject , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
| Implementory | UIFTETextField, UITextField |
| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
Bieżące opcje dostępności tego obiektu wyświetlanego. | IFlexDisplayObject | |
| alpha : Number
Wartość przezroczystości alfa określonego obiektu. | IFlexDisplayObject | |
| alwaysShowSelection : Boolean
Jeśli ma wartość prawda, a pole tekstowe nie jest aktywne, program Flash Player wyróżnia zaznaczenie w polu tekstowym kolorem szarym. | IUITextField | ||
| antiAliasType : String
Typ wygładzania w tym polu tekstowym. | IUITextField | ||
| autoSize : String
Steruje automatycznym wymiarowaniem oraz wyrównywaniem pola tekstowego. | IUITextField | ||
| background : Boolean
Określa, czy pole tekstowe ma wypełnione tło. | IUITextField | ||
| backgroundColor : uint
Kolor tła pola tekstowego. | IUITextField | ||
| baselinePosition : Number [tylko do odczytu]
The y-coordinate of the baseline
of the first line of text of the component. | IUIComponent | |
| blendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć. | IFlexDisplayObject | |
| border : Boolean
Określa, czy pole tekstowe ma obramowanie. | IUITextField | ||
| borderColor : uint
Kolor obramowania pola tekstowego. | IUITextField | ||
| bottomScrollV : int [tylko do odczytu]
Liczba całkowita oznaczająca indeks ostatniego (na samym dole) z wierszy widocznych w polu tekstowym, liczona od 1. | IUITextField | ||
| cacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego. | IFlexDisplayObject | |
| caretIndex : int [tylko do odczytu]
Indeks położenia punktu wstawiania (karetki). | IUITextField | ||
| 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). | IUITextField | ||
| defaultTextFormat : flash.text:TextFormat
Określa format wstawianego tekstu, np. tekstu wprowadzanego przez użytkownika lub wstawianego za pomocą metody replaceSelectedText(). | IUITextField | ||
| displayAsPassword : Boolean
Wskazuje, czy pole tekstowe jest polem hasła. | IUITextField | ||
| document : Object
A reference to the document object associated with this component. | IUIComponent | |
| doubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia). | IUITextField | ||
| embedFonts : Boolean
Określa, czy mają być stosowane osadzone kontury czcionek. | IUITextField | ||
| enabled : Boolean
Whether the component can accept user interaction. | IUIComponent | |
| enableIME : Boolean [tylko do odczytu]
Specifies whether the IME should be enabled when
this component has focus. | IIMESupport | |
| explicitHeight : Number
The explicitly specified height for the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitMaxHeight : Number [tylko do odczytu]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitMaxWidth : Number [tylko do odczytu]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitMinHeight : Number [tylko do odczytu]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitMinWidth : Number [tylko do odczytu]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| explicitWidth : Number
The explicitly specified width for the component,
in pixels, as the component's coordinates. | IUIComponent | |
| filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | IFlexDisplayObject | |
| focusPane : Sprite
A single Sprite object that is shared among components
and used as an overlay for drawing the focus indicator. | IUIComponent | |
| focusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności. | IUITextField | ||
| gridFitType : String
Typ dopasowywania do siatki w tym polu tekstowym. | IUITextField | ||
| height : Number
Wysokość obiektu ekranowego w pikselach. | IFlexDisplayObject | |
| htmlText : String
Zawiera reprezentację zawartości pola tekstowego w formacie HTML. | IUITextField | ||
| ignorePadding : Boolean
If true, the paddingLeft and
paddingRight styles will not add space
around the text of the component. | IUITextField | ||
| imeMode : String
The IME mode of the component. | IIMESupport | |
| includeInLayout : Boolean
Specifies whether this component is included in the layout of the
parent container. | IUIComponent | |
| inheritingStyles : Object
The beginning of this UITextField's chain of inheriting styles. | IUITextField | ||
| isPopUp : Boolean
Set to true by the PopUpManager to indicate
that component has been popped up. | IUIComponent | |
| length : int [tylko do odczytu]
Liczba znaków w polu tekstowym. | IUITextField | ||
| loaderInfo : LoaderInfo [tylko do odczytu]
Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany. | IFlexDisplayObject | |
| mask : DisplayObject
Wywoływany obiekt wyświetlany jest maskowany przez określony obiekt maski. | IFlexDisplayObject | |
| maxChars : int
Maksymalna liczba znaków, które użytkownik może wprowadzić w polu tekstowym. | IUITextField | ||
| maxHeight : Number [tylko do odczytu]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| maxScrollH : int [tylko do odczytu]
Maksymalna wartość scrollH. | IUITextField | ||
| maxScrollV : int [tylko do odczytu]
Maksymalny zakres scrollV | IUITextField | ||
| maxWidth : Number [tylko do odczytu]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| measuredHeight : Number [tylko do odczytu]
The measured height of this object. | IFlexDisplayObject | |
| measuredMinHeight : Number
The default minimum height of the component, in pixels. | IUIComponent | |
| measuredMinWidth : Number
The default minimum width of the component, in pixels. | IUIComponent | |
| measuredWidth : Number [tylko do odczytu]
The measured width of this object. | IFlexDisplayObject | |
| minHeight : Number [tylko do odczytu]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| minWidth : Number [tylko do odczytu]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | |
| mouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. | IUITextField | ||
| 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. | IUITextField | ||
| mouseX : Number [tylko do odczytu]
Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach. | IFlexDisplayObject | |
| mouseY : Number [tylko do odczytu]
Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach. | IFlexDisplayObject | |
| multiline : Boolean
Określa, czy pole tekstowe jest polem wielowierszowym. | IUITextField | ||
| name : String
Nazwa instancji obiektu DisplayObject. | IFlexDisplayObject | |
| nestLevel : int
Depth of this object in the containment hierarchy. | IUITextField | ||
| nonInheritingStyles : Object
The beginning of this UITextField's chain of non-inheriting styles. | IUITextField | ||
| nonZeroTextHeight : Number [tylko do odczytu]
Unlike textHeight, this returns a non-zero value
even when the text is empty. | IUITextField | ||
| numLines : int [tylko do odczytu]
Określa liczbę wierszy w wielowierszowym polu tekstowym. | IUITextField | ||
| opaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty. | IFlexDisplayObject | |
| owner : DisplayObjectContainer
The owner of this IVisualElement object. | IUIComponent | |
| parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | IFlexDisplayObject | |
| percentHeight : Number
Number that specifies the height of a component as a
percentage of its parent's size. | IUIComponent | |
| percentWidth : Number
Number that specifies the width of a component as a
percentage of its parent's size. | IUIComponent | |
| restrict : String
Oznacza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym. | IUITextField | ||
| 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. | IFlexDisplayObject | |
| rotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach). | IFlexDisplayObject | |
| scale9Grid : Rectangle
Aktualnie stosowana siatka skalowania. | IFlexDisplayObject | |
| scaleX : Number
Wskazuje skalę poziomą (procent) obiektu względem punktu odniesienia. | IFlexDisplayObject | |
| scaleY : Number
Wskazuje skalę pionową (procent) obiektu względem punktu odniesienia. | IFlexDisplayObject | |
| scrollH : int
Bieżące położenie podczas przewijania poziomego. | IUITextField | ||
| scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | IFlexDisplayObject | |
| scrollV : int
Pionowe położenie tekstu w polu tekstowym. | IUITextField | ||
| selectable : Boolean
Wartość typu Boolean wskazująca, czy dane pole tekstowe można zaznaczać. | IUITextField | ||
| selectionBeginIndex : int [tylko do odczytu]
Indeks pierwszego znaku w bieżącym zaznaczeniu, liczony od 0. | IUITextField | ||
| selectionEndIndex : int [tylko do odczytu]
Indeks ostatniego znaku w bieżącym zaznaczeniu, liczony od 0. | IUITextField | ||
| sharpness : Number
Ostrość krawędzi glifów w polu tekstowym. | IUITextField | ||
| stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | IFlexDisplayObject | |
| styleName : Object
The source of this object's style values. | ISimpleStyleClient | |
| styleSheet : StyleSheet
Dołącza do pola tekstowego arkusz stylu. | IUITextField | ||
| systemManager : ISystemManager
A reference to the SystemManager object for this component. | IUIComponent | |
| tabEnabled : Boolean
Określa, czy do tego obiektu można przejść za pomocą klawisza Tab. | IUITextField | ||
| tabIndex : int
Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. | IUITextField | ||
| text : String
Ciąg znaków odpowiadający bieżącemu tekstowi w polu tekstowym. | IUITextField | ||
| textColor : uint
Kolor tekstu w polu tekstowym (w formacie szesnastkowym). | IUITextField | ||
| textHeight : Number [tylko do odczytu]
Wysokość tekstu w pikselach. | IUITextField | ||
| textWidth : Number [tylko do odczytu]
Szerokość tekstu w pikselach. | IUITextField | ||
| thickness : Number
Grubość krawędzi glifów w polu tekstowym. | IUITextField | ||
| toolTip : String
The text of this component's tooltip. | IToolTipManagerClient | |
| transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | IFlexDisplayObject | |
| tweeningProperties : Array
Used by EffectManager. | IUIComponent | |
| type : String
Typ pola tekstowego. | IUITextField | ||
| useRichTextClipboard : Boolean
Określa, czy razem z tekstem można kopiować i wklejać jego format. | IUITextField | ||
| visible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie. | IFlexDisplayObject | |
| width : Number
Szerokość obiektu ekranowego w pikselach. | IFlexDisplayObject | |
| wordWrap : Boolean
Wartość typu Boolean wskazująca, że tekst w polu tekstowym może być zawijany. | IUITextField | ||
| x : Number
Oznacza współrzędną x instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | IFlexDisplayObject | |
| y : Number
Oznacza współrzędną y instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | IFlexDisplayObject | |
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
| 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. | IEventDispatcher | |
Dołącza ciąg wskazany w parametrze newText na końcu tekstu w polu tekstowym. | IUITextField | ||
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | IEventDispatcher | |
|
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace). | IFlexDisplayObject | |
Zwraca prostokąt będący obwiednią znaku. | IUITextField | ||
Zwraca indeks znaku (liczony od 0) w punkcie określonym za pomocą parametrów x i y. | IUITextField | ||
|
A convenience method for determining whether to use the
explicit or measured height
| IUIComponent | |
|
A convenience method for determining whether to use the
explicit or measured width
| IUIComponent | |
Po otrzymaniu indeksu znaku zwraca indeks pierwszego znaku w tym samym akapicie. | IUITextField | ||
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>. | IUITextField | ||
Zwraca indeks (liczony od 0) wiersza określonego za pomocą parametrów x i y. | IUITextField | ||
Zwraca liczony od 0 indeks wiersza zawierającego znak określony przez parametr charIndex. | IUITextField | ||
Zwraca liczbę znaków w określonym wierszu tekstowym. | IUITextField | ||
Zwraca informacje o wymiarach danego wiersza tekstu. | IUITextField | ||
Zwraca indeks pierwszego znaku w wierszu określonego przez parametr lineIndex. | IUITextField | ||
Zwraca wiersz tekstowy określony przez parametr lineIndex. | IUITextField | ||
Po podaniu indeksu znaku zwraca wartość długości akapitu zawierający dany znak. | IUITextField | ||
|
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). | IFlexDisplayObject | |
Gets a style property that has been set anywhere in this
component's style lookup chain. | IUITextField | ||
Zwraca obiekt TextFormat, który zawiera informacje o formatowaniu dla zakresu tekstu określonego przez parametry beginIndex i endIndex. | IUITextField | ||
Returns a UITextFormat object that contains formatting information for this component. | IUITextField | ||
|
Konwertuje obiekt punktowy ze współrzędnych obiektu Stage (globalne) do współrzędnych obiektu wyświetlanego (lokalne). | IFlexDisplayObject | |
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | IEventDispatcher | |
|
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. | IFlexDisplayObject | |
|
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y. | IFlexDisplayObject | |
|
Initialize the object. | IUIComponent | |
|
Calling this method results in a call to the component's
validateDisplayList() method
before the display list is rendered. | IInvalidating | |
|
Calling this method results in a call to the component's
validateProperties() method
before the display list is rendered. | IInvalidating | |
|
Calling this method results in a call to the component's
validateSize() method
before the display list is rendered. | IInvalidating | |
|
Konwertuje obiekt punktowy ze współrzędnych obiektu wyświetlanego (lokalne) do współrzędnych obiektu Stage (globalne). | IFlexDisplayObject | |
|
Moves this object to the specified x and y coordinates. | IFlexDisplayObject | |
|
Returns true if the chain of owner properties
points from child to this UIComponent. | IUIComponent | |
|
Called by Flex when a UIComponent object is added to or removed from a parent. | IUIComponent | |
|
Usuwa detektor z obiektu EventDispatcher. | IEventDispatcher | |
Zastępuje bieżące zaznaczenie zawartością określoną przez parametr wartości. | IUITextField | ||
Zastępuje zakres znaków określony przez parametry beginIndex i endIndex zawartością parametru newText. | IUITextField | ||
|
Sets the actual size of this object. | IFlexDisplayObject | |
Sets the font color of the text. | IUITextField | ||
Sets the focus to this component. | IUITextField | ||
Zaznacza tekst określony wartościami indeksu pierwszego i ostatniego znaku, podanymi w parametrach beginIndex oraz endIndex. | IUITextField | ||
Stosuje formatowanie tekstowe określone przez parametr formatowania do danego tekstu w polu tekstowym. | IUITextField | ||
|
Called when the visible property changes. | IUIComponent | |
|
Called when the value of a style property is changed. | ISimpleStyleClient | |
Truncate text to make it fit horizontally in the area defined for the control,
and append an ellipsis, three periods (...), to the text. | IUITextField | ||
|
Validates and updates the properties and layout of this object
by immediately calling validateProperties(),
validateSize(), and validateDisplayList(),
if necessary. | IInvalidating | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | IEventDispatcher | |
alwaysShowSelection | właściwość |
alwaysShowSelection:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get alwaysShowSelection():Boolean public function set alwaysShowSelection(value:Boolean):voidantiAliasType | właściwość |
antiAliasType:String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidautoSize | właściwość |
autoSize:String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidbackground | właściwość |
background:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get background():Boolean public function set background(value:Boolean):voidbackgroundColor | właściwość |
backgroundColor:uint| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidborder | właściwość |
border:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get border():Boolean public function set border(value:Boolean):voidborderColor | właściwość |
borderColor:uint| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidbottomScrollV | właściwość |
bottomScrollV:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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():intcaretIndex | właściwość |
caretIndex:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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():intcondenseWhite | właściwość |
condenseWhite:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voiddefaultTextFormat | właściwość |
defaultTextFormat:flash.text:TextFormat| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voiddisplayAsPassword | właściwość |
displayAsPassword:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voiddoubleClickEnabled | właściwość |
doubleClickEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voidembedFonts | właściwość |
embedFonts:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get embedFonts():Boolean public function set embedFonts(value:Boolean):voidfocusRect | właściwość |
focusRect:Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get focusRect():Object public function set focusRect(value:Object):voidgridFitType | właściwość |
gridFitType:String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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. |
Implementacja
public function get gridFitType():String public function set gridFitType(value:String):voidhtmlText | właściwość |
htmlText:String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidignorePadding | właściwość |
ignorePadding:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
If true, the paddingLeft and
paddingRight styles will not add space
around the text of the component.
Implementacja
public function get ignorePadding():Boolean public function set ignorePadding(value:Boolean):voidinheritingStyles | właściwość |
inheritingStyles:Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get inheritingStyles():Object public function set inheritingStyles(value:Object):voidlength | właściwość |
maxChars | właściwość |
maxChars:int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get maxChars():int public function set maxChars(value:int):voidmaxScrollH | właściwość |
maxScrollV | właściwość |
mouseEnabled | właściwość |
mouseEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidmouseWheelEnabled | właściwość |
mouseWheelEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidmultiline | właściwość |
multiline:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get multiline():Boolean public function set multiline(value:Boolean):voidnestLevel | właściwość |
nestLevel:int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get nestLevel():int public function set nestLevel(value:int):voidnonInheritingStyles | właściwość |
nonInheritingStyles:Object| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get nonInheritingStyles():Object public function set nonInheritingStyles(value:Object):voidnonZeroTextHeight | właściwość |
nonZeroTextHeight:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get nonZeroTextHeight():NumbernumLines | właściwość |
numLines:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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():intrestrict | właściwość |
restrict:String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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";
Implementacja
public function get restrict():String public function set restrict(value:String):voidscrollH | właściwość |
scrollH:int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidscrollV | właściwość |
scrollV:int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidselectable | właściwość |
selectable:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get selectable():Boolean public function set selectable(value:Boolean):voidselectionBeginIndex | właściwość |
selectionBeginIndex:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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():intselectionEndIndex | właściwość |
selectionEndIndex:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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():intsharpness | właściwość |
sharpness:Number| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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).
Implementacja
public function get sharpness():Number public function set sharpness(value:Number):voidstyleSheet | właściwość |
styleSheet:StyleSheet| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidtabEnabled | właściwość |
tabEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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ść
truedla obiektu SimpleButton. - Wartość
truedla obiektu TextField z właściwościątype = "input". - Wartość
truedla obiektu Sprite lub obiektu MovieClip z właściwościąbuttonMode = true.
Implementacja
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | właściwość |
tabIndex:int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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;Aby odwrócić kolejność aktywacji klawiszem Tab względem ustawienia domyślnego dla trzech instancji obiektu TLFTextField (
tlfInstance1, tlfInstance2 i tlfInstance3), należy użyć poniższego kodu:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementacja
public function get tabIndex():int public function set tabIndex(value:int):voidtext | właściwość |
text:String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.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.
Implementacja
public function get text():String public function set text(value:String):voidtextColor | właściwość |
textColor:uint| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
Implementacja
public function get textColor():uint public function set textColor(value:uint):voidtextHeight | właściwość |
textWidth | właściwość |
thickness | właściwość |
thickness:Number| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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).
Implementacja
public function get thickness():Number public function set thickness(value:Number):voidtype | właściwość |
type:String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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ć.
Implementacja
public function get type():String public function set type(value:String):voiduseRichTextClipboard | właściwość |
useRichTextClipboard:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidwordWrap | właściwość |
wordWrap:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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):voidappendText | () | metoda |
public function appendText(newText:String):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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 — The string to append to the existing text.
|
getCharBoundaries | () | metoda |
public function getCharBoundaries(charIndex:int):Rectangle| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca prostokąt będący obwiednią znaku.
Parametry
charIndex:int — The zero-based index value for the character (for example, the first
position is 0, the second position is 1, and so on).
|
Rectangle — A rectangle with x and y minimum and maximum values
defining the bounding box of the character.
|
getCharIndexAtPoint | () | metoda |
public function getCharIndexAtPoint(x:Number, y:Number):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca indeks znaku liczony od 0 w punkcie określonym parametrami x i y.
Parametry
x:Number — The x coordinate of the character.
| |
y:Number — The y coordinate of the character.
|
int — The zero-based index value of the character (for example, the first position is 0,
the second position is 1, and so on). Returns -1 if the point is not over any character.
|
getFirstCharInParagraph | () | metoda |
public function getFirstCharInParagraph(charIndex:int):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Po otrzymaniu indeksu znaku zwraca indeks pierwszego znaku w tym samym akapicie.
Parametry
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — The zero-based index value of the first character in the same paragraph.
|
getImageReference | () | metoda |
public function getImageReference(id:String):DisplayObject| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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 — The id to match (in the id attribute of the
<img> tag).
|
DisplayObject — The display object corresponding to the image or SWF file with the matching id
attribute in the <img> tag of the text field. For media loaded from an external source,
this object is a Loader object, and, once loaded, the media object is a child of that Loader object. For media
embedded in the SWF file, it is the loaded object. If no <img> tag with
the matching id exists, the method returns null.
|
getLineIndexAtPoint | () | metoda |
public function getLineIndexAtPoint(x:Number, y:Number):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca liczony od 0 indeks wiersza o podanym położeniu określonym przez parametry x i y.
Parametry
x:Number — The x coordinate of the line.
| |
y:Number — The y coordinate of the line.
|
int — The zero-based index value of the line (for example, the first line is 0, the
second line is 1, and so on). Returns -1 if the point is not over any line.
|
getLineIndexOfChar | () | metoda |
public function getLineIndexOfChar(charIndex:int):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca liczony od 0 indeks wiersza zawierającego znak określony przez parametr charIndex.
Parametry
charIndex:int — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — The zero-based index value of the line.
|
getLineLength | () | metoda |
public function getLineLength(lineIndex:int):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca liczbę znaków w określonym wierszu tekstowym.
Parametry
lineIndex:int — The line number for which you want the length.
|
int — The number of characters in the line.
|
getLineMetrics | () | metoda |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca informacje o wymiarach danego wiersza tekstu.
Parametry
lineIndex:int — The line number for which you want metrics information.
|
flash.text:TextLineMetrics — A TextLineMetrics object.
|
getLineOffset | () | metoda |
public function getLineOffset(lineIndex:int):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca indeks pierwszego znaku w wierszu określonego przez parametr lineIndex.
Parametry
lineIndex:int — The zero-based index value of the line (for example, the first line is 0,
the second line is 1, and so on).
|
int — The zero-based index value of the first character in the line.
|
getLineText | () | metoda |
public function getLineText(lineIndex:int):String| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Zwraca wiersz tekstowy określony przez parametr lineIndex.
Parametry
lineIndex:int — The zero-based index value of the line (for example, the first line is 0,
the second line is 1, and so on).
|
String — The text string contained in the specified line.
|
getParagraphLength | () | metoda |
public function getParagraphLength(charIndex:int):int| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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 — The zero-based index value of the character (for example, the first character is 0,
the second character is 1, and so on).
|
int — Returns the number of characters in the paragraph.
|
getStyle | () | metoda |
public function getStyle(styleProp:String):*| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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
styleProp:String — Name of the style property.
|
* — Style value.
|
getTextFormat | () | metoda |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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) | |
endIndex:int (default = -1)beginIndex and endIndex values,
the text from beginIndex to endIndex-1 is read.
|
flash.text:TextFormat — The TextFormat object that represents the formatting properties for the specified text.
|
getUITextFormat | () | metoda |
public function getUITextFormat():mx.core:UITextFormat| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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().
mx.core:UITextFormat — An object that contains formatting information for this component.
|
replaceSelectedText | () | metoda |
public function replaceSelectedText(value:String):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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 — The string to replace the currently selected text.
|
replaceText | () | metoda |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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 — The zero-based index value for the start position of the replacement range.
| |
endIndex:int — The zero-based index position of the first character after the desired
text span.
| |
newText:String — The text to use to replace the specified range of characters.
|
setColor | () | metoda |
setFocus | () | metoda |
public function setFocus():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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.
setSelection | () | metoda |
public function setSelection(beginIndex:int, endIndex:int):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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 — The zero-based index value of the first character in the selection
(for example, the first character is 0, the second character is 1, and so on).
| |
endIndex:int — The zero-based index value of the last character in the selection.
|
setTextFormat | () | metoda |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
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 — A TextFormat object that contains character and paragraph formatting information.
| |||||||||
beginIndex:int (default = -1) | |||||||||
endIndex:int (default = -1)beginIndex and endIndex values,
the text from beginIndex to endIndex-1 is updated.
Notice that any text inserted manually by the user, or replaced by the
|
truncateToFit | () | metoda |
public function truncateToFit(truncationIndicator:String = null):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flex 3 |
| Wersje środowiska wykonawczego: | Flash Player 9, AIR 1.1 |
Truncate text to make it fit horizontally in the area defined for the control, and append an ellipsis, three periods (...), to the text.
Parametry
truncationIndicator:String (default = null)null, a localizable string
such as "..." will be used.
|
Boolean — true if the text needed truncation.
|
Tue Jun 12 2018, 12:06 PM Z