TLFTextField  - AS3 Flash

Jeśli ma wartość true, a pole tekstowe nie jest aktywne, program Flash Player wyróżnia zaznaczenie w polu tekstowym kolorem jasno-niebieskim. Jeśli ma wartość false, a pole tekstowe jest aktywne, program Flash Player nie wyróżnia zaznaczenia w polu tekstowym.

Przykład:

		package 
		{
		    import flash.display.Sprite;
		    import fl.text.TLFTextField;
		    import flash.text.TextFieldType;
		
    	    public class TLFTextField_alwaysShowSelection extends Sprite 
		    {
		
		        public function TLFTextField_alwaysShowSelection() 
		        {
		            var label1:TLFTextField = createTLFTextField(0, 20, 200, 20);
		            label1.text = "This text is selected.";
		            label1.setSelection(0, 9);
		            label1.alwaysShowSelection = true;
		
		            var label2:TLFTextField = createTLFTextField(0, 50, 200, 20);
		            label2.text = "Drag to select some of this text.";
		        }
		
		        private function createTLFTextField(x:Number, y:Number, width:Number, height:Number):TLFTextField 
		        {
		            var result:TLFTextField = new TLFTextField();
		            result.x = x; 
		            result.y = y;
		            result.width = width; 
		            result.height = height;
		            addChild(result);
		            return result;
		        }
		    }
		}
		

Wartością domyślną jest false.

Powiązane elementy interfejsu API

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 jest osadzona (właściwość embedFonts ustawiona na wartość true).

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ą domyślną jest flash.text.AntiAliasType.NORMAL.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

Określa, czy pole tekstowe ma wypełnione tło. Wartość true oznacza, że tło pola tekstowego zawiera wypełnienie. Wartość false oznacza, że tło pola tekstowego nie zawiera wypełnienia. Właściwość backgroundColor służy do ustawienia koloru tła pola tekstowego.

Wartością domyślną jest false.

Powiązane elementy interfejsu API

Określa wartość alfa tła pola tekstowego. Wartość alfa tła może należeć do przedziału od 0 (tło niewidoczne) do 1 (tło lite). Tę właściwość można pobrać lub ustawić, nawet w przypadku braku tła w danym momencie. Jednakże efekt alfa będzie widoczny tylko wówczas, gdy właściwość background pola tekstowego będzie ustawiona na wartośćtrue.

Wartością domyślną jest 1.0.

Powiązane elementy interfejsu API

Określa kolor tła pola tekstowego. 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.

Wartością domyślną jest 0xFFFFFF (white).

Powiązane elementy interfejsu API

Określa pionowy lub poziomy przyrost położenia przy rozmieszczaniu wierszy. Wiersze są rozmieszczane od góry do dołu (BlockProgression.TB — dla tekstu poziomego) lub od prawej do lewej (BlockProgression.RL — dla tekstu pionowego).

Poprawne wartości to: flashx.textLayout.formats.BlockProgression.RL, flashx.textLayout.formats.BlockProgression.TB, flashx.textLayout.formats.FormatValue.INHERIT.

Jeśli wartość undefined zostanie przekazana kaskadowo, właściwość odziedziczy wartość z obiektu macierzystego. Jeśli w żadnym obiekcie nadrzędnym ta właściwość nie będzie ustawiona, przyjęta zostanie wartość TB.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Określa, czy pole tekstowe ma obramowanie. Wartość true oznacza, że pole tekstowe ma obramowanie. Wartość false oznacza, że pole tekstowe nie ma obramowania. Właściwość borderColor umożliwia ustawienie koloru obramowania.

Wartością domyślną jest false.

Powiązane elementy interfejsu API

Określa wartość alfa obramowania. Wartość alfa obramowania może należeć do przedziału od 0 (obramowanie niewidoczne) do 1 (obramowanie lite). Tę właściwość można pobrać lub ustawić, nawet w przypadku braku obramowania w danym momencie. Jednakże efekt alfa będzie widoczny tylko wówczas, gdy właściwość border pola tekstowego będzie ustawiona na wartośćtrue.

Wartością domyślną jest 1.0.

Powiązane elementy interfejsu API

Określa 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.

Powiązane elementy interfejsu API

Określa szerokość obramowania. Szerokość obramowania może należeć do przedziału od 1 do 100. Tę właściwość można pobrać lub ustawić nawet w przypadku braku obramowania w danym momencie. Jednakże szerokość będzie widoczna tylko wówczas, gdy właściwość border pola tekstowego będzie ustawiona na wartość true.

Szerokość obramowania jest uwzględniana przy obliczaniu szerokości i wysokość pola tekstowego. Aby pobrać szerokość lub wysokość kontenera tekstu bez obramowania, należy odjąć dwukrotność właściwości borderWidth od wartości szerokości lub wysokości.

Na przykład: txtHeight = tlf.height - (2 tlf.borderwidth);.

Wartością domyślną jest 1.

Powiązane elementy interfejsu API

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ę w górnej części okna, a właściwość bottomScroll indeks ostatniego z wierszy widocznych w oknie.

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.

Powiązane elementy interfejsu API

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

Przykład:

		package 
		{
			import flash.display.Sprite;
			import flash.events.MouseEvent;
			import fl.text.TLFTextField;
			import flash.text.TextFieldType;
		
			public class TLFTextField_caretIndex extends Sprite 
			{
				public function TLFTextField_caretIndex() 
				{
					var tlf:TLFTextField = createTLFTextField(10, 10, 100, 100);
					tlf.wordWrap = true;
					tlf.type = TextFieldType.INPUT;
					tlf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text.";
					tlf.addEventListener(MouseEvent.CLICK, printCursorPosition);
				}
		
				private function printCursorPosition(event:MouseEvent):void 
				{
					var tlf:TLFTextField = TLFTextField(event.currentTarget);
					trace("caretIndex:", tlf.caretIndex);
					trace("selectionBeginIndex:", tlf.selectionBeginIndex);
					trace("selectionEndIndex:", tlf.selectionEndIndex);
				}
		
				private function createTLFTextField(x:Number, y:Number, width:Number, height:Number):TLFTextField 
				{
					var result:TLFTextField = new TLFTextField();
					result.x = x;
					result.y = y;
					result.width = width;
					result.height = height;
					addChild(result);
					return result;
				}
			}
		}		 
		

Powiązane elementy interfejsu API

Liczba kolumn tekstu (jeśli kaskadowo zostanie przekazana wartość undefined, przyjmowana jest wartość domyślna). Liczba kolumn przesłania inne ustawienia kolumn. Wartość jest liczbą całkowitą; jeśli nie zostanie określona, przyjmowana jest wartość FormatValue.AUTO. Jeśli wartość columnCount nie jest określona, wówczas wartość columnWidth jest wykorzystywana w celu utworzenia tak dużej liczby kolumn, jaka może zmieścić się w kontenerze.

Poprawne wartości wyrażone jako stała to: flashx.textLayout.formats.FormatValue.AUTO, flashx.textLayout.formats.FormatValue.INHERIT, a także liczby int z zakresu od 1 do 50.

Jeśli przekazana kaskadowo właściwość będzie miała wartość undefined, zostanie przyjęta wartość AUTO.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Określa odstęp między kolumnami w pikselach (jeśli przekazana kaskadowo wartość jest równa undefined, przyjmowana jest wartość domyślna).

Wartości dozwolone to liczby z zakresu od 0 do 1000 oraz flashx.textLayout.formats.FormatValue.INHERIT.

Jeśli przekazana kaskadowo właściwość będzie miała wartość undefined, zostanie przyjęta wartość 20.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Szerokość kolumny w pikselach (jeśli przekazana kaskadowo wartość jest równa undefined, przyjmowana jest wartość domyślna). Jeśli zostanie określona szerokość kolumny, ale nie zostanie określona liczba kolumn, TextLayout utworzy maksymalną liczbę kolumn o określonej szerokości, z uwzględnieniem szerokości kontenera i ustawień columnGap. Ewentualne wolne miejsce jest pozostawiane za ostatnią kolumną. Wartość jest liczbą.

Poprawne wartości wyrażone jako stała to: flashx.textLayout.formats.FormatValue.AUTO, flashx.textLayout.formats.FormatValue.INHERIT, a także liczby z zakresu od 0 do 8000.

Jeśli przekazana kaskadowo właściwość będzie miała wartość undefined, zostanie przyjęta wartość AUTO.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Wartość typu Boolean, która określa czy z pola tekstowego HTML lub znacznika TLF mają być usuwane nadmiarowe białe znaki (np. spacje i znaki podziału). Wartością domyślną jest false. Właściwość condenseWhite dotyczy tylko znacznika TLF lub 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 znaków podziału w polu tekstowym należy użyć standardowych znaczników HTML, takich jak <br> i <p>.

Właściwość condenseWhite należy ustawić przed ustawieniem właściwości htmlText lub właściwości tlfMarkup.

W poniższym przykładzie przedstawiono sposób użycia właściwości condenseWhite w celu usunięcia odstępu od treści tlfMarkup:

		 import fl.text.TLFTextField;
		 
		 var my_tlf:TLFTextField = new TLFTextField();
		 my_tlf.autoSize = 'left';
		 
		 // This line removes white space from tlfMarkup
		 my_tlf.condenseWhite = true;
		 
		 addChild(my_tlf);
		 
		 var my_markup:String =   '<TextFlow xmlns="http://ns.adobe.com/textLayout/2008">'
		 					+ '	<p>'
		 					+ '		<span>Here is the first span.</span>'
		 					+ ' 	       \n'
		 					+ '		<span>And here is the second span.</span>'
		 					+ '	</p>'
		 					+ '</TextFlow>';
		 					
		 my_tlf.tlfMarkup = my_markup;
		 

Wartością domyślną jest false.

Powiązane elementy interfejsu API

Określa format wstawianego tekstu, np. tekstu wprowadzanego przez użytkownika lub wstawianego za pomocą metody replaceSelectedText().

Powiązane elementy interfejsu API

Określa domyślny dwukierunkowy poziom osadzenia tekstu w bloku tekstu. Kolejność odczytu od lewej do prawej, jak w skryptach w stylu łacińskim, lub od prawej do lewej, jak w języku arabskim lub hebrajskim. Ta właściwość wpływa również na kierunek kolumny po zastosowaniu jej na poziomie kontenera. Kolumny mogą być czytane od lewej do prawej lub na odwrót, podobnie jak tekst. Poniżej przedstawiono kilka przykładów:

Poprawne wartości to: flashx.textLayout.formats.Direction.LTR, flashx.textLayout.formats.Direction.RTL, flashx.textLayout.formats.FormatValue.INHERIT.

Jeśli wartość undefined zostanie przekazana kaskadowo, właściwość odziedziczy wartość z obiektu macierzystego. Jeśli w żadnym obiekcie nadrzędnym ta właściwość nie będzie ustawiona, przyjęta zostanie wartość LTR.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Wskazuje, czy pole tekstowe jest polem hasła. Wartość true tej właściwości oznacza, że pole tekstowe jest traktowane jak pole hasła i ukrywa wpisywane znaki, wyświetlając w ich miejscu znaki gwiazdki. Wartość false oznacza, że pole tekstowe nie jest traktowane jak pole hasła. Włączony tryb hasła uniemożliwia korzystanie z poleceń Wytnij i Kopiuj, a odpowiadające im skróty klawiaturowe nie będą aktywne. Ten mechanizm zabezpieczający uniemożliwia nieuprawnionemu użytkownikowi korzystanie ze skrótów w celu odkrycia hasła do komputera pozostawionego bez nadzoru.

Wartością domyślną jest false.

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 zostanie wyświetlony za pomocą czcionki rezerwowej.

Wartością domyślną jest false.

Powiązane elementy interfejsu API

Określa położenie linii bazowej dla pierwszego wiersza w kontenerze. Ustawienia narodowe na poziomie kontenera określają, do której linii bazowej odwołuje się ta właściwość. W językach japońskim i chińskim przyjmowana jest wartość TextBaseline.IDEOGRAPHIC_BOTTOM; we wszystkich innych językach przyjmowana jest wartość TextBaseline.ROMAN. Przesunięcie od górnego zwężenia (lub prawego zwężenia, jeśli blockProgression ma wartość RL) kontenera do linii bazowej pierwszego wiersza może mieć wartość BaselineOffset.ASCENT, co oznacza równość górnemu wydłużeniu wiersza; BaselineOffset.LINE_HEIGHT, co oznacza równość wysokości pierwszego wiersza, lub dowolną stałą wartość w celu określenia odległości bezwzględnej. BaselineOffset.AUTO zrównuje wydłużenie górne wiersza z górnym zwężeniem kontenera.

Dozwolone wartości to ciągi znaków flashx.textLayout.formats.BaselineOffset.AUTO, flashx.textLayout.formats.BaselineOffset.ASCENT, flashx.textLayout.formats.BaselineOffset.LINE_HEIGHT, flashx.textLayout.formats.FormatValue.INHERIT oraz liczby z zakresu od 0 do 1000.

Jeśli wartość undefined zostanie przekazana kaskadowo, właściwość odziedziczy wartość z obiektu macierzystego. Jeśli w żadnym obiekcie nadrzędnym ta właściwość nie będzie ustawiona, przyjęta zostanie wartość AUTO.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

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ą domyślną jest flash.text.GridFitType.PIXEL.

Powiązane elementy interfejsu API

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

Instancje klasy TLFTextField obsługują następujące znaczniki HTML:

Program Flash obsługuje również jawne kody znaków, jak np. & (ampersand w kodzie ASCII) czy € (symbol € w kodzie Unicode).

Powiązane elementy interfejsu API

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.

Wartością domyślną jest 0.

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

Powiązane elementy interfejsu API

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

Powiązane elementy interfejsu API

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. Za pomocą tej właściwości można zablokować przewijanie tekstu przy użyciu pokrętła myszy w polu tekstowym lub zaimplementować własny sposób przewijania tekstu w polu tekstowym.

Wartością domyślną jest true.

Określa, czy pole tekstowe jest polem wielowierszowym. Wartość true wskazuje, że pole tekstowe jest polem wielowierszowym; wartość false wskazuje, że pole tekstowe jest polem jednowierszowym. W przypadku pola typu TextFieldType.INPUT wartość multiline określa, czy naciśnięcie klawisza Enter powoduje utworzenie nowego wiersza (false powoduje, że naciśnięcie klawisza Enter jest ignorowane). Jeśli tekst zostanie wklejony do pola TextField z wartością multiline równą false, nowe wiersze znajdują się poza tekstem.

Wartością domyślną jest false.

Powiązane elementy interfejsu API

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

Powiązane elementy interfejsu API

Dolne zwężenie w pikselach (jeśli przekazana kaskadowo wartość jest równa undefined, przyjmowana jest wartość domyślna). Odstęp między dolną krawędzią kontenera a tekstem. Wartość jest liczbą.

W przypadku tekstu poziomego w kontenerach przewijanych z wieloma kolumnami pierwsza kolumna i kolejne kolumny przedstawiają dopełnienie jako odstęp u dołu kontenera, ale w przypadku ostatniej kolumny (jeśli cały tekst się nie mieści) konieczne może być przewinięcie w celu wyświetlenia dopełnienia.

Wartości dozwolone to liczby z zakresu od 0 do 1000 oraz flashx.textLayout.formats.FormatValue.INHERIT.

Jeśli przekazana kaskadowo właściwość będzie miała wartość undefined, zostanie przyjęta wartość 0.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Lewe zwężenie w pikselach (jeśli przekazana kaskadowo wartość jest równa undefined, przyjmowana jest wartość domyślna). Odstęp między lewą krawędzią kontenera a tekstem. Wartość jest liczbą.

W przypadku tekstu pionowego w kontenerach przewijanych z wieloma kolumnami pierwsze i kolejne kolumny przedstawiają dopełnienie jako pusty odstęp na końcu kontenera, ale w przypadku ostatniej kolumny (jeśli cały tekst się nie mieści) konieczne może być przewinięcie w celu wyświetlenia dopełnienia.

Wartości dozwolone to liczby z zakresu od 0 do 1000 oraz flashx.textLayout.formats.FormatValue.INHERIT.

Jeśli przekazana kaskadowo właściwość będzie miała wartość undefined, zostanie przyjęta wartość 0.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Prawe zwężenie w pikselach (jeśli przekazana kaskadowo wartość jest równa undefined, przyjmowana jest wartość domyślna). Odstęp między prawą krawędzią kontenera a tekstem. Wartość jest liczbą.

Wartości dozwolone to liczby z zakresu od 0 do 1000 oraz flashx.textLayout.formats.FormatValue.INHERIT.

Jeśli przekazana kaskadowo właściwość będzie miała wartość undefined, zostanie przyjęta wartość 0.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Górne zwężenie w pikselach (jeśli przekazana kaskadowo wartość jest równa undefined, przyjmowana jest wartość domyślna). Odstęp między górną krawędzią kontenera a tekstem. Wartość jest liczbą.

Wartości dozwolone to liczby z zakresu od 0 do 1000 oraz flashx.textLayout.formats.FormatValue.INHERIT.

Jeśli przekazana kaskadowo właściwość będzie miała wartość undefined, zostanie przyjęta wartość 0.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API

Pobiera lub ustawia znak używany do ukrywania znaków w bloku hasła.

Maksymalna wartość właściwości pixelScrollV. Jednostkami właściwości pixelMaxScrollV są piksele (w odróżnieniu od właściwości maxScrollV, która jest oparta na wierszach).

Pionowe położenie tekstu w polu tekstowym podawane w pikselach (w odróżnieniu od właściwości scrollV, która jest oparta na wierszach). Właściwość pixelScrollV ułatwia płynne przewijanie obiektu textField do określonego położenia.

Powiązane elementy interfejsu API

Oznacza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym. Jeśli wartością właściwości restrict jest wartość null, użytkownik może wprowadzić dowolny znak. Jeśli wartością właściwości restrict jest pusty ciąg znaków, użytkownik nie może wprowadzić żadnego znaku. Jeśli wartością właściwości restrict jest ciąg znaków, użytkownik może wprowadzić do pola tekstowego tylko znaki z tego ciągu. Ciąg znaków jest przeszukiwany od lewej do prawej. Zakres można zdefiniować za pomocą znaku myślnika (-). Ograniczone są tylko interakcje użytkownika; skrypt może umieścić w polu tekstowym dowolny tekst. Tej właściwości nie można zsynchronizować z opcjami osadzania czcionki w inspektorze właściwości.

Jeśli ciąg znaków rozpoczyna się od znaku karetki (^), wszystkie znaki są początkowo akceptowane, a następujące po nich znaki w ciągu są wykluczane ze zbioru znaków akceptowanych. Jeśli ciąg znaków nie rozpoczyna się od znaku karetki (^), żadne znaki nie są początkowo akceptowane, a następujące po nich znaki w ciągu zostają zawarte w zbiorze znaków akceptowanych.

W poniższym przykładzie do pola tekstowego można wprowadzić tylko znaki dużej litery, spacje oraz liczby.

		 my_txt.restrict = "A-Z 0-9";
		 

Poniższy przykład ilustruje włączenie wszystkich znaków z wyjątkiem tych pisanych małą literą:

		 my_txt.restrict = "^a-z";
		 

Aby wprowadzić znaczenie znaku karetki (^) lub kreski (-) można użyć ukośnika odwrotnego. Akceptowalne sekwencje zawierające ukośnik odwrotny to: \-, \^ lub \\. Ukośnik odwrotny musi stanowić rzeczywisty znak w ciągu znaków, dlatego w języku ActionScript należy użyć podwójnego znaku ukośnika odwrotnego. Na przykład poniższy kod zawiera tylko znak kreski (-) i karetki z (^):

		 my_txt.restrict = "\\-\\^";
		 

Znaku ^ można użyć w dowolnym miejscu ciągu znaków — umożliwia włączanie i wykluczanie znaków. Poniższy kod włącza tylko znaki dużych liter, ale wyłącza literę Q:

		 my_txt.restrict = "A-Z^Q";
		 

Za pomocą sekwencji zmiany znaczenia \u można budować zastrzeżone ciągi znaków. Poniższy kod zawiera tylko znaki ASCII od numeru 32 (spacja) do 126 (tylda).

		 my_txt.restrict = "\u0020-\u007E";
		 

Wartością domyślną jest null.

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

Wartość typu Boolean wskazująca, czy dane pole tekstowe można zaznaczać. Wartość true oznacza, że tekst można zaznaczać. Właściwość selectable steruje możliwością zaznaczania, a nie edycji tekstu w polu tekstowym. W odróżnieniu od klasycznych dynamicznych lub wejściowych pól tekstowych, edytowalne pola tekstowe TLF zawsze umożliwiają zaznaczanie. Jeśli ta właściwość jest ustawiona na false, a wybranym typem wprowadzania jest typ dynamic, użytkownik nie może zaznaczać tekstu.

Jeśli właściwość selectable jest ustawiona na wartość false, tekst w polu tekstowym nie reaguje na polecenia zaznaczenia lub ich skróty klawiszowe i nie można go 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.

Wartością domyślną jest true.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

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.

Powiązane elementy interfejsu API

Właściwość ostrości nie ma zastosowania do pól tekstowych TLF. Wszelkie podane wartości będą ignorowane i zawsze zwracana będzie wartość zero.

Arkusze stylów dla obiektów TLF TextField.

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.

Powiązane elementy interfejsu API

Kolor tekstu w polu tekstowym (w formacie szesnastkowym). W szesnastkowym systemie kolorów wartości kolorów są reprezentowane za pomocą sześciu cyfr. Dla każdej cyfry istnieje szesnaście możliwych wartości lub znaków. Zakres znaków obejmuje cyfry od 0 do 9, a następnie litery od A do F. Na przykład reprezentacja koloru czarnego 0x000000, a białego to 0xFFFFFF.

Wartością domyślną jest 0 (0x000000).

Ta właściwość umożliwia przypisanie formatowania z klas TLF zawartych w pakietach flashx do instancji klasy TLFTextField. Na przykład:

		 var myFormat:TextLayoutFormat = new TextLayoutFormat();
		 myFormat.textIndent = 8;
		 myFormat.color = 0x336633;
		 myFormat.fontFamily = "Arial, Helvetica, _sans";
		 myFormat.fontSize = 24;
		 
		 var myTextFlow:TextFlow = myTLFTextField.textFlow;
		 myTextFlow.hostFormat = myFormat;
		 

Powiązane elementy interfejsu API

Wysokość tekstu w pikselach. Do tej wartości nie jest wliczany odstęp od górnej i dolnej krawędzi.

Powiązane elementy interfejsu API

Szerokość tekstu w pikselach. Do tej wartości nie jest wliczany odstęp od prawej i lewej krawędzi.

Powiązane elementy interfejsu API

Właściwość grubości nie ma zastosowania do pól tekstowych TLF. Wszelkie podane wartości będą ignorowane i zawsze zwracana będzie wartość zero.

Ustawia lub pobiera znaczniki TLF tekstu w polu tekstowym TLF.

Specyfikację znaczników opublikowano na stronie http://sourceforge.net/projects/tlf.adobe/files/docs/TLF_2.0_specification.pdf/download.

Powiązane elementy interfejsu API

Typ pola tekstowego. Jedna z dwóch następujących stałych TextFieldType: TextFieldType.DYNAMIC określająca pole tekstowe TLF z możliwością zaznaczania, którego użytkownik nie może edytować, lub TextFieldType.INPUT określająca edytowalne pole tekstowe TLF, które użytkownik może edytować.

Wartością domyślną jest dynamic.

Powiązane elementy interfejsu API

Określa, czy tekst będzie kopiowany do schowka razem z formatowaniem. W przypadku ustawienia wartości true program, Flash Player kopiuje do schowka formatowanie (takie jak wyrównanie, pogrubienie lub kursywa) w formacie tlfMarkup.

Wartością domyślną jest false.

Powiązane elementy interfejsu API

Wyrównanie pionowe lub justowanie (jeśli wartość przekazana kaskadowo jest równa undefined, przyjmowana jest wartość domyślna). Określa, w jaki sposób elementy TextFlow są wyrównywane w kontenerze.

Poprawne wartości to: flashx.textLayout.formats.VerticalAlign.TOP, flashx.textLayout.formats.VerticalAlign.MIDDLE, flashx.textLayout.formats.VerticalAlign.BOTTOM, flashx.textLayout.formats.VerticalAlign.JUSTIFY, flashx.textLayout.formats.FormatValue.INHERIT.

Jeśli przekazana kaskadowo właściwość będzie miała wartość undefined, zostanie przyjęta wartość TOP.

Wartością domyślną jest undefined (indicates not set).

Powiązane elementy interfejsu API