Pakiet | flash.text |
Klasa | public final class StageText |
Dziedziczenie | StageText EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Ta klasa umożliwia aplikacjom dla urządzeń przenośnych uzyskiwanie danych wprowadzanych przez użytkownika za pomocą natywnych elementów sterujących do wprowadzania tekstu na urządzeniach przenośnych. Elementy sterujące do wprowadzania danych na urządzeniach przenośnych często oferują zaawansowany interfejs użytkownika oraz funkcje niedostępne na komputerach. Na przykład wiele urządzeń przenośnych obsługuje funkcje wprowadzania tekstu, takie jak:
- automatyczne uzupełnianie,
- automatyczne poprawianie,
- zaznaczanie tekstu dotykiem,
- dostosowywalna klawiatura programowa.
System operacyjny (lub dołączona do niego biblioteka składników) rysuje natywne pola do wprowadzania tekstu. Natywne pola do wprowadzania tekstu działają w sposób znany dla każdego, kto korzystał z innych aplikacji na tym samym urządzeniu. Jednak ze względu na to, że pola do wprowadzania tekstu rysuje system operacyjny, a nie odtwarzacz, nie można używać czcionek osadzonych.
Obsługa profilów AIR: Ta funkcja jest dostępna na platformach iOS i Android. Klasa StageText korzysta z natywnych pól do wprowadzania tekstu na urządzeniach przenośnych z systemami Android i iOS. Na innych platformach klasa StageText korzysta z klasy TextField środowiska wykonawczego Flash.
W przypadku korzystania z natywnych elementów do wprowadzania danych obiekty StageText nie są obiektami ekranowymi i nie można ich dodawać do listy wyświetlania programu Flash. Zamiast tego w celu wyświetlenia obiektu StageText należy dołączyć go bezpośrednio do stołu montażowego za pomocą właściwości stage
. Wystąpienie obiektu StageText dołączone do stołu montażowego jest wyświetlane przed wszystkimi obiektami ekranowymi programu Flash. Rozmiarem i położeniem obszaru renderowania można sterować przy użyciu właściwości viewPort
. Nie ma możliwości sterowania kolejnością (głębokością) poszczególnych obiektów StageText. Nie jest zalecane nakładanie dwóch wystąpień.
Gdy obiekt StageText jest aktywny, może jako pierwszy obsługiwać dane wprowadzane za pomocą klawiatury. Stół montażowy, do którego jest dołączony obiekt StageText, nie przekazuje żadnych zdarzeń dotyczących wprowadzania danych za pomocą klawiatury.
Klasa StageText opakowuje różne natywne elementy sterujące na różnych platformach, dlatego jej funkcje są obsługiwane w różnym stopniu przez poszczególne platformy. Gdy funkcje są obsługiwane, mogą działać odmiennie na różnych platformach. Chcąc użyć określonej funkcji na określonej platformie, najlepiej jest przetestować jej zachowanie. Zachowanie klasy StageText jest podobne do obsługi tekstu przez środowisko wykonawcze Flash tylko w przypadku platform komputerowych, na których nie są używane natywne elementy sterujące.
Domyślnie ogniskowanie w Apple TV skupia się na obiekcie StageText. Aby zarządzać ogniskowaniem między różnymi obiektami w aplikacji, należy pamiętać o następujących kwestiach:
- Aby zastąpić domyślne ogniskowanie na obiekcie StageText lub przypisać ogniskowanie do innego wyświetlanego obiektu, należy użyć właściwości stage.focus
- Aby przypisać ogniskowanie do obiektu StageText, należy użyć właściwości stageText.assignFocus()
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
autoCapitalize : String
Steruje sposobem automatycznego określania wielkości liter dla danych wprowadzanych przez użytkownika na urządzeniu. | StageText | ||
autoCorrect : Boolean
Wskazuje, czy urządzenie automatycznie poprawia błędy pisowni i błędy interpunkcyjne w danych wprowadzanych przez użytkownika. | StageText | ||
clearButtonMode : String [tylko do zapisu]
Tryb obiektu clearButton dla bieżącego obiektu StageText. | StageText | ||
color : uint
Określa kolor tekstu. | StageText | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
displayAsPassword : Boolean
Wskazuje, czy pole tekstowe jest polem hasła. | StageText | ||
editable : Boolean
Wskazuje, czy użytkownik może edytować pole tekstowe. | StageText | ||
fontFamily : String
Wskazuje nazwę bieżącej rodziny czcionek. | StageText | ||
fontPosture : String
Określa ułożenie czcionki za pomocą stałych zdefiniowanych w klasie FontPosture. | StageText | ||
fontSize : int
Rozmiar w pikselach dla bieżącej rodziny czcionek. | StageText | ||
fontWeight : String
Określa grubość czcionki za pomocą stałych zdefiniowanych w klasie FontWeight. | StageText | ||
locale : String
Określa ustawienia regionalne tekstu. | StageText | ||
maxChars : int
Wskazuje maksymalną liczbę znaków, które użytkownik może wprowadzać w polu tekstowym. | StageText | ||
multiline : Boolean [tylko do odczytu]
Wskazuje, czy w obiekcie StageText można wyświetlać więcej niż jeden wiersz tekstu. | StageText | ||
restrict : String
Ogranicza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym. | StageText | ||
returnKeyLabel : String
Wskazuje etykietę na klawiszu Return dla urządzeń udostępniających klawiaturę programową. | StageText | ||
selectionActiveIndex : int [tylko do odczytu]
Indeks ostatniego znaku w bieżącym zaznaczeniu, liczony od 0. | StageText | ||
selectionAnchorIndex : int [tylko do odczytu]
Indeks pierwszego znaku w bieżącym zaznaczeniu, liczony od 0. | StageText | ||
softKeyboardType : String
Steruje wyglądem klawiatury programowej. | StageText | ||
stage : Stage
Stół montażowy, na którym jest wyświetlany ten obiekt StageText. | StageText | ||
text : String
Bieżący tekst w polu tekstowym. | StageText | ||
textAlign : String
Wskazuje wyrównanie akapitu. | StageText | ||
viewPort : Rectangle
Obszar stołu montażowego, w którym jest wyświetlany obiekt StageText. | StageText | ||
visible : Boolean
Wskazuje, czy obiekt StageText jest widoczny. | StageText |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Tworzy obiekt StageText. | StageText | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | ||
Uaktywnia obiekt StageText. | StageText | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Zwalnia obiekt StageText. | StageText | ||
Rysuje widok klasy StageText na bitmapie. | StageText | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Zaznacza tekst określony przez wartości indeksu pierwszego i ostatniego znaku. | StageText | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
---|---|---|---|---|
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | |||
Wywoływane, gdy zawartość tekstowa ulegnie zmianie. | StageText | |||
Wywoływane po ustawieniu właściwości stage innej niż null i ustawieniu niepustej właściwości viewPort. | StageText | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Wywoływane, gdy użytkownik edytuje tekst i element sterujący jest aktywnym obiektem powiązanym z klawiaturą. | StageText | |||
Wywoływane, gdy użytkownik przestanie edytować tekst i element sterujący nie będzie już aktywnym obiektem powiązanym z klawiaturą. | StageText | |||
Wywoływane, gdy użytkownik naciśnie klawisz. | StageText | |||
Wywoływane, gdy użytkownik zwolni klawisz. | StageText | |||
Wywoływane po włączeniu klawiatury programowej, na przykład gdy obiekt StageText stanie się aktywny. | StageText | |||
Wywoływane przed włączeniem klawiatury programowej, na przykład gdy obiekt StageText stanie się aktywny. | StageText | |||
Wywoływane po wyłączeniu klawiatury programowej, na przykład gdy obiekt StageText przestanie być aktywny. | StageText |
autoCapitalize | właściwość |
autoCapitalize:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Steruje sposobem automatycznego określania wielkości liter dla danych wprowadzanych przez użytkownika na urządzeniu. Poprawne wartości są zdefiniowane jako stałe w klasie AutoCapitalize:
- none
- word
- sentence
- all
Ta właściwość jest tylko wskazówką dla platformy, ponieważ nie wszystkie urządzenia i systemy operacyjne obsługują tę funkcję.
Uwaga: W przypadku włączenia opcji autoCapitalize
w czasie, gdy tekst jest edytowany lub aktywny z innego powodu, zmodyfikowane zachowanie jest uaktywniane dopiero po zwolnieniu i ponownym uzyskaniu punktu skupienia.
Wartością domyślną jest AutoCapitalize.NONE.
Implementacja
public function get autoCapitalize():String
public function set autoCapitalize(value:String):void
Zgłasza
ArgumentError — Jeśli ustawiona jest dowolna wartość, która nie jest elementem klasy AutoCapitalize .
|
Powiązane elementy interfejsu API
autoCorrect | właściwość |
autoCorrect:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wskazuje, czy urządzenie automatycznie poprawia błędy pisowni i błędy interpunkcyjne w danych wprowadzanych przez użytkownika.
Ta właściwość jest tylko wskazówką dla platformy, ponieważ nie wszystkie urządzenia i systemy operacyjne obsługują tę funkcję.
Uwaga: W przypadku włączenia opcji autoCorrect
w czasie, gdy tekst jest edytowany lub aktywny z innego powodu, zmodyfikowane zachowanie jest uaktywniane dopiero po zwolnieniu i ponownym uzyskaniu punktu skupienia.
Wartością domyślną jest false.
Implementacja
public function get autoCorrect():Boolean
public function set autoCorrect(value:Boolean):void
clearButtonMode | właściwość |
clearButtonMode:String
[tylko do zapisu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 23 |
Tryb obiektu clearButton dla bieżącego obiektu StageText. Z tą właściwością powiązane są cztery tryby:
-
Wyświetlanie obiektu clearButton podczas edycji:
StageTextClearButtonMode.WHILE_EDITING
-
Brak wyświetlania obiektu clearButton:
StageTextClearButtonMode.NEVER
-
Wyświetlanie obiektu clearButton zawsze:
StageTextClearButtonMode.ALWAYS
-
Wyświetlanie obiektu clearButton z pominięciem edycji:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode
to StageTextClearButtonMode.WHILE_EDITING
.
Uwaga: ta właściwość jest obsługiwana tylko dla systemu iOS.
Implementacja
public function set clearButtonMode(value:String):void
color | właściwość |
color:uint
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Określa kolor tekstu. Kolor tekstu należy określić jako liczbę zawierającą trzy 8-bitowe składniki RGB. Pierwszy składnik reprezentuje kolor czerwony, drugi reprezentuje kolor zielony, a trzeci reprezentuje kolor niebieski. Na przykład wartość 0xFF0000
określa kolor czerwony, wartość 0x00FF00
określa kolor zielony, a wartość 0x0000FF
określa kolor niebieski. Domyślny kolor tekstu to czarny (0x000000
).
Wartością domyślną jest 0x000000.
Implementacja
public function get color():uint
public function set color(value:uint):void
displayAsPassword | właściwość |
displayAsPassword:Boolean
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wskazuje, czy pole tekstowe jest polem hasła. W przypadku wartości true
znaki wprowadzane w polu tekstowym są ukrywane przy użyciu znaku zastępczego (na przykład gwiazdki).
Uwaga: W przypadku włączenia opcji displayAsPassword
w czasie, gdy tekst jest edytowany lub aktywny z innego powodu, zmodyfikowane zachowanie jest uaktywniane dopiero po zwolnieniu i ponownym uzyskaniu punktu skupienia.
Ważne: jeśli ta właściwość ma wartość true
w systemie iOS, znaki zastępcze nie są wyświetlane w wielowierszowym obiekcie tekstowym stołu montażowego.
Wartością domyślną jest false.
Implementacja
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | właściwość |
fontFamily | właściwość |
fontFamily:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wskazuje nazwę bieżącej rodziny czcionek. Wartość null wskazuje domyślne ustawienie systemu. Aby wyliczyć dostępne czcionki, należy użyć funkcji flash.text.Font.enumerateFonts()
. Jeśli rodzina czcionek jest nieznana, używana jest domyślna rodzina czcionek.
Wartością domyślną jest null.
Implementacja
public function get fontFamily():String
public function set fontFamily(value:String):void
fontPosture | właściwość |
fontPosture:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Określa ułożenie czcionki za pomocą stałych zdefiniowanych w klasie FontPosture.
Wartością domyślną jest FontPosture.NORMAL.
Implementacja
public function get fontPosture():String
public function set fontPosture(value:String):void
Zgłasza
ArgumentError — Jeśli ustawiona jest dowolna wartość, która nie jest elementem klasy FontPosture .
|
Powiązane elementy interfejsu API
fontSize | właściwość |
fontWeight | właściwość |
fontWeight:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Określa grubość czcionki za pomocą stałych zdefiniowanych w klasie FontWeight.
Wartością domyślną jest FontWeight.NORMAL.
Implementacja
public function get fontWeight():String
public function set fontWeight(value:String):void
Zgłasza
ArgumentError — Jeśli ustawiona jest dowolna wartość, która nie jest elementem klasy FontWeight .
|
Powiązane elementy interfejsu API
locale | właściwość |
locale:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Określa ustawienia regionalne tekstu. Klasa StageText korzysta ze standardowych identyfikatorów ustawień regionalnych. Na przykład „en”, „en_US” i „en-US” oznaczają język angielski, a „ja” oznacza język japoński. Listę kodów ustawień regionalnych można znaleźć pod adresem iso639-2 code list.
Wartością domyślną jest en.
Implementacja
public function get locale():String
public function set locale(value:String):void
maxChars | właściwość |
maxChars:int
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wskazuje maksymalną liczbę znaków, które użytkownik może wprowadzać w polu tekstowym. Skrypt może wstawić tekst o długości większej niż dozwolona wartość określona we właściwości maxChars
. Jeśli właściwość maxChars
ma wartość zero, użytkownik może wprowadzić nieograniczoną ilość tekstu w polu tekstowym.
Wartością domyślną jest 0.
Implementacja
public function get maxChars():int
public function set maxChars(value:int):void
multiline | właściwość |
multiline:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wskazuje, czy w obiekcie StageText można wyświetlać więcej niż jeden wiersz tekstu. Tylko do odczytu. Ta wartość odpowiada właściwości multiline
w obiekcie StageTextInitOptions, która jest używana podczas konstruowania.
Implementacja
public function get multiline():Boolean
Powiązane elementy interfejsu API
restrict | właściwość |
restrict:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Ogranicza zestaw znaków, które użytkownik może wprowadzać w polu tekstowym. System skanuje ciąg znaków restrict
od lewej do prawej.
Wartość właściwości restrict
określa następujące reguły ograniczeń wprowadzania tekstu:
- Jeśli wartość jest równa
null
, użytkownik może wprowadzić dowolny znak. - Jeśli wartość jest pustym ciągiem znaków, użytkownik nie może wprowadzać żadnych znaków.
- Jeśli wartość jest ciągiem znaków, użytkownik może wprowadzać tylko znaki z tego ciągu znaków.
- Jeśli wartość zawiera znak karetki (^), użytkownik nie może wprowadzać żadnych znaków występujących za tym znakiem.
- W wartości można określić dozwolony zakres wprowadzanych znaków, używając znaku myślnika (-).
- Do skonstruowania ciągu znaków
restrict
można użyć sekwencji zmiany znaczenia\u
w wartości.
Znaki specjalne:
Aby wprowadzić znak karetki (^) lub kreski (-), należy użyć ukośnika odwrotnego. Akceptowalne sekwencje zawierające ukośnik odwrotny to: \-, \^ oraz \\. Ukośnik odwrotny musi stanowić rzeczywisty znak w ciągu znaków. Aby określić ukośnik odwrotny w języku ActionScript, należy użyć podwójnego ukośnika odwrotnego.
Przykłady ustawień właściwości restrict
:
W poniższym przykładzie użytkownik będzie mógł wprowadzać tylko znaki kreski (-) i karetki (^):
my_txt.restrict = "\\-\\^";
W poniższym przykładzie użytkownik będzie mógł wprowadzać tylko wielkie litery, spacje i liczby:
my_txt.restrict = "A-Z 0-9";
W poniższym przykładzie są wykluczane tylko małe litery:
my_txt.restrict = "^a-z";
W poniższym przykładzie użytkownik będzie mógł wprowadzać tylko wielkie litery z wyjątkiem wielkiej litery Q:
my_txt.restrict = "A-Z^Q";
W poniższym przykładzie użytkownik będzie mógł wprowadzać tylko znaki o kodach ASCII od 32 (spacja) do 126 (tylda).
my_txt.restrict = "\u0020-\u007E";
Uwaga: Ograniczenia dotyczą tylko danych wprowadzanych przez użytkownika. Skrypt może wstawić dowolne znaki w polu tekstowym.
Wartością domyślną jest null.
Implementacja
public function get restrict():String
public function set restrict(value:String):void
returnKeyLabel | właściwość |
returnKeyLabel:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wskazuje etykietę na klawiszu Return dla urządzeń udostępniających klawiaturę programową. Dostępne wartości to stałe zdefiniowane w klasie ReturnKeyLabel
:
- default
- done
- go
- next
- search
Ta właściwość jest tylko wskazówką dla platformy, ponieważ nie wszystkie urządzenia i systemy operacyjne obsługują te wartości. Ta właściwość nie ma wpływu na urządzenia, które nie oferują klawiatury programowej.
Wartością domyślną jest ReturnKeyLabel.DEFAULT.
Implementacja
public function get returnKeyLabel():String
public function set returnKeyLabel(value:String):void
Zgłasza
ArgumentError — Jeśli ustawiona jest dowolna wartość nienależąca do klasy ReturnKeyLabel .
|
Powiązane elementy interfejsu API
selectionActiveIndex | właściwość |
selectionActiveIndex:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Indeks ostatniego znaku w bieżącym zaznaczeniu, liczony od 0. Na przykład liczba dla pierwszego znaku to 0, dla drugiego to 1, itd.
Jeśli nie jest zaznaczony żaden tekst, ta metoda zwraca punkt wstawiania. Jeśli wystąpienie klasy StageText nie jest aktywne, ta metoda zwraca wartość –1.
W systemie iOS ta właściwość nie jest obsługiwana dla obiektów StageText, które nie zawierają wielu wierszy. W takich sytuacjach zwracana jest wartość –1.
Implementacja
public function get selectionActiveIndex():int
Powiązane elementy interfejsu API
selectionAnchorIndex | właściwość |
selectionAnchorIndex:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Indeks pierwszego znaku w bieżącym zaznaczeniu, liczony od 0. Na przykład liczba dla pierwszego znaku to 0, dla drugiego to 1, itd.
Jeśli nie jest zaznaczony żaden tekst, ta metoda zwraca punkt wstawiania. Jeśli wystąpienie klasy StageText nie jest aktywne, ta metoda zwraca wartość –1.
W systemie iOS ta właściwość nie jest obsługiwana dla obiektów StageText, które nie zawierają wielu wierszy. W takich sytuacjach zwracana jest wartość –1.
Implementacja
public function get selectionAnchorIndex():int
Powiązane elementy interfejsu API
softKeyboardType | właściwość |
softKeyboardType:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Steruje wyglądem klawiatury programowej.
Urządzenia z klawiaturą programową pozwalają dostosowywać jej przyciski do oczekiwanego typu wprowadzanych danych. Jeśli na przykład będą wprowadzane dane liczbowe, urządzenie może użyć wartości SoftKeyboardType.NUMBER
w celu wyświetlania wyłącznie cyfr na klawiaturze programowej. Poprawne wartości są zdefiniowane jako stałe w klasie SoftKeyboardType:
- default
- punctuation
- url
- number
- contact
- phone
- decimalpad
Te wartości stanowią wskazówki dla urządzenia ułatwiające wyświetlenie najlepszej klawiatury dla bieżącej operacji.
Wartością domyślną jest SoftKeyboardType.DEFAULT.
Implementacja
public function get softKeyboardType():String
public function set softKeyboardType(value:String):void
Zgłasza
ArgumentError — Jeśli ustawiona jest dowolna wartość nienależąca do klasy SoftKeyboardType .
|
Powiązane elementy interfejsu API
stage | właściwość |
stage:Stage
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Stół montażowy, na którym jest wyświetlany ten obiekt StageText.
Aby ukryć ten obiekt StageText, należy dla właściwości stage
ustawić wartość null
.
Wartością domyślną jest null.
Implementacja
public function get stage():Stage
public function set stage(value:Stage):void
text | właściwość |
text:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Bieżący tekst w polu tekstowym. Znak powrotu karetki (\r
, kod ASCII 13) oddziela wiersze tekstu. Tekst w tej właściwości jest niesformatowany (nie zawiera znaczników formatowania).
Wartością domyślną jest null.
Implementacja
public function get text():String
public function set text(value:String):void
textAlign | właściwość |
textAlign:String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wskazuje wyrównanie akapitu. Poprawne wartości są zdefiniowane jako stałe w klasie TextFormatAlign:
- left
- center
- right
- justify
- start
- klawiszEnd
Niektóre platformy nie obsługują pewnych wartości textAlign
. W przypadku nieobsługiwanych wartości textAlign
stosowana jest wartość domyślna (TextFormatAlign.START
).
Wartością domyślną jest TextFormatAlign.START.
Implementacja
public function get textAlign():String
public function set textAlign(value:String):void
Zgłasza
ArgumentError — Jeśli ustawiona jest dowolna wartość należąca do klasy TextFormatAlign .
|
Powiązane elementy interfejsu API
viewPort | właściwość |
viewPort:Rectangle
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Obszar stołu montażowego, w którym jest wyświetlany obiekt StageText. Ustawieniem domyślnym jest prostokąt z wartościami zerowymi.
Implementacja
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Zgłasza
RangeError — Wartość Rectangle jest nieprawidłowa.
|
visible | właściwość |
StageText | () | Konstruktor |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Tworzy obiekt StageText.
Obiekt StageText pozostaje niewidoczny, dopóki nie zostanie dołączony do stołu montażowego i nie zostanie ustawiona właściwość viewPort
.
initOptions:flash.text:StageTextInitOptions (default = null )
|
assignFocus | () | metoda |
public function assignFocus():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Uaktywnia obiekt StageText. Użycie funkcji assignFocus()
nie odnosi żadnego skutku w przypadku obiektów, które nie umożliwiają edycji.
dispose | () | metoda |
public function dispose():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Zwalnia obiekt StageText.
Wywołanie metody dispose()
jest opcjonalne. Jeśli nie zostanie zachowane odniesienie do tego wystąpienia obiektu StageText, wystąpienie będzie podlegało procesowi czyszczenia pamięci. Wywołanie metody dispose()
może spowodować wykonanie czyszczenia pamięci wcześniej lub w dogodniejszym momencie.
drawViewPortToBitmapData | () | metoda |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3.0 |
Rysuje widok klasy StageText na bitmapie.
Można przechwycić bitmapę i ustawić wartość stołu montażowego wynoszącą null
w celu wyświetlenia zawartości nad obiektem StageText.
Bitmapa ma zazwyczaj tę samą wysokość i szerokość co widok. Od wersji AIR 15.0 w przypadku, gdy odtwarzacz działa na ekranie o wysokiej rozdzielczości, szerokość i wysokość bitmapy można opcjonalnie pomnożyć contentsScaleFactor
razy szerokość i wysokość widoku. Na przykład na monitorze Retina komputera Mac parametr contentsScaleFactor
ma wartość 2. Rozdzielczość pikseli stołu montażowego jest dwukrotna, dlatego bitmapa może mieć rozmiar dwa razy większy niż widok.
W przypadku wywołania tej metody przed zdarzeniem Event.COMPLETE
metoda może narysować widok nieprawidłowo.
Parametry
bitmap:BitmapData — Obiekt BitmapData, na którym ma zostać narysowana widoczna część widoku klasy StageText.
|
Zgłasza
ArgumentError — Szerokość lub wysokość bitmapy różni się od szerokości lub wysokości widoku.
| |
Error — Bitmapa jest pusta.
|
selectRange | () | metoda |
public function selectRange(anchorIndex:int, activeIndex:int):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Zaznacza tekst określony przez wartości indeksu pierwszego i ostatniego znaku. Pierwszy i ostatni znak zaznaczenia są określane w parametrach anchorIndex
i activeIndex
. Jeśli obie wartości parametrów są jednakowe, ta metoda ustawia punkt wstawiania.
Ta funkcja nie jest obsługiwana i zawsze zwraca wartość –1 w przypadku obiektów StageText w systemie iOS, które nie są obiektami wielowierszowymi. W przypadku wywołania tej metody i zaznaczenia całego ciągu tekstowego zaznaczenie jest widoczne. Wywołanie tej metody i zaznaczenie podzbioru ciągu tekstowego powoduje, że zaznaczenie nie jest widoczne.
W przypadku niektórych urządzeń i systemów operacyjnych zaznaczenie jest widoczne tylko wtedy, gdy obiekt StageText jest aktywny.
Parametry
anchorIndex:int — Indeks pierwszego znaku zaznaczenia, liczony od 0 (wartość indeksu pierwszego znaku wynosi 0).
| |
activeIndex:int — Indeks ostatniego znaku zaznaczenia, liczony od 0.
|
Powiązane elementy interfejsu API
change | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.CHANGE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane, gdy zawartość tekstowa ulegnie zmianie. To zdarzenie może być wywoływane po każdej zmianie albo po zakończeniu kilku zmian.
StałaEvent.CHANGE
definiuje wartość właściwości type
obiektu zdarzenia change
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Wartość obiektu została zmodyfikowana. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
complete | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.COMPLETE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane po ustawieniu właściwości stage innej niż null i ustawieniu niepustej właściwości viewPort. Wskazuje, że implementacja zakończyła tworzenie układu obiektu StageText i można wywołać metodę drawViewPortToBitmapData
. Zależnie od platformy zdarzenie to może być wywoływane synchronicznie lub asynchronicznie z ustawieniem właściwości stage
, viewPort
lub obu tych właściwości.
Event.COMPLETE
definiuje wartość właściwości type
obiektu zdarzenia complete
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt sieciowy, którego ładowanie zostało ukończone. |
focusIn | Zdarzenie |
flash.events.FocusEvent
właściwość FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane, gdy użytkownik edytuje tekst i element sterujący jest aktywnym obiektem powiązanym z klawiaturą.
Definiuje wartość właściwościtype
obiektu zdarzenia focusIn
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
keyCode | 0; ma zastosowanie wyłącznie do zdarzeń keyFocusChange . |
relatedObject | Komplementarna instancja klasy InteractiveObject, która zmienia się wskutek przeniesienia aktywności. |
shiftKey | false ; ma zastosowanie wyłącznie do zdarzeń keyFocusChange . |
target | Instancja klasy InteractiveObject, która właśnie stała się aktywna. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie.
|
direction | Kierunek, z którego przypisano fokus. Ta właściwość przyjmuje wartość parametru direction metody assignFocus() stołu montażowego. Jeśli fokus został przeniesiony w inny sposób, właściwość będzie miała zawsze wartość FocusDirection.NONE . Ma zastosowanie wyłącznie do zdarzeń focusIn . Dla wszystkich pozostałych zdarzeń związanych z fokusem właściwość ma wartość FocusDirection.NONE . |
focusOut | Zdarzenie |
flash.events.FocusEvent
właściwość FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane, gdy użytkownik przestanie edytować tekst i element sterujący nie będzie już aktywnym obiektem powiązanym z klawiaturą.
Definiuje wartość właściwościtype
obiektu zdarzenia focusOut
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
keyCode | 0; ma zastosowanie wyłącznie do zdarzeń keyFocusChange . |
relatedObject | Komplementarna instancja klasy InteractiveObject, która zmienia się wskutek przeniesienia aktywności. |
shiftKey | false ; ma zastosowanie wyłącznie do zdarzeń keyFocusChange . |
target | Instancja klasy InteractiveObject, która właśnie utraciła aktywność. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie.
|
keyDown | Zdarzenie |
flash.events.KeyboardEvent
właściwość KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane, gdy użytkownik naciska klawisz.
Mapowanie pomiędzy klawiszami a określonymi znakami zmienia się w zależności od urządzenia i systemu operacyjnego. To zdarzenie jest generowane po mapowaniu tego typu, ale przed przetwarzaniem edytora metody wprowadzania (IME). Edytory IME są przydatne w przypadku wprowadzania znaków, do których nie są dostosowane standardowe klawiatury QWERTY (na przykład ideogramów chińskich).
Zdarzenie to występuje przed zdarzeniem keyUp
.
To zdarzenie nie jest wywoływane dla wszystkich kluczy. Klawisze, które powodują wywołanie tego zdarzenia, różnią się w zależności od platformy.
W środowisku AIR anulowanie tego zdarzenia uniemożliwia wprowadzenie znaku w polu tekstowym.
StałaScreenMouseEvent.KEY_DOWN
definiuje wartość właściwości type
obiektu zdarzenia keyDown
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | true w AIR, false w programie Flash Player; anulowanie zdarzenia w środowisku AIR zapobiega wprowadzeniu znaku do pola tekstowego. |
charCode | Kod znaku naciśniętego lub zwolnionego klawisza. |
commandKey | true w systemie Mac, jeśli klawisz Command jest aktywny. W przeciwnym razie false |
controlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemie Mac, jeśli którykolwiek klawisz Control jest aktywny. W przeciwnym razie false |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false . |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
keyCode | Kod znaku przypisanego do klawisza, który wciśnięto lub zwolniono. |
keyLocation | Położenie klawisza na klawiaturze. |
shiftKey | true , jeśli klawisz Shift jest aktywny; false , jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject, która jest aktywna. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
keyUp | Zdarzenie |
flash.events.KeyboardEvent
właściwość KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane, gdy użytkownik zwalnia klawisz.
Mapowanie pomiędzy klawiszami a określonymi znakami zmienia się w zależności od urządzenia i systemu operacyjnego. To zdarzenie jest generowane po mapowaniu tego typu, ale przed przetwarzaniem edytora metody wprowadzania (IME). Edytory IME umożliwiają wprowadzanie znaków, do których nie są dostosowane standardowe klawiatury QWERTY (na przykład ideogramów chińskich).
Zdarzenie to ma miejsce po zdarzeniu keyDown
.
To zdarzenie nie jest wywoływane dla wszystkich kluczy. Klawisze, które powodują wywołanie tego zdarzenia, różnią się w zależności od platformy.
StałaScreenMouseEvent.KEY_UP
definiuje wartość właściwości type
obiektu zdarzenia keyUp
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
charCode | Zawiera kod znaku przypisanego do klawisza, który wciśnięto lub zwolniono. |
commandKey | true w systemie Mac, jeśli klawisz Command jest aktywny. W przeciwnym razie false |
controlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemie Mac, jeśli którykolwiek klawisz Control jest aktywny. W przeciwnym razie false |
ctrlKey | true w systemach Windows, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false . |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
keyCode | Kod znaku przypisanego do klawisza, który wciśnięto lub zwolniono. |
keyLocation | Położenie klawisza na klawiaturze. |
shiftKey | true , jeśli klawisz Shift jest aktywny; false , jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject, która jest aktywna. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
softKeyboardActivate | Zdarzenie |
flash.events.SoftKeyboardEvent
właściwość SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane po włączeniu klawiatury programowej, na przykład gdy obiekt StageText stanie się aktywny.
StałaSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
definiuje wartość właściwości type
obiektu SoftKeyboardEvent, gdy jest wyświetlana klawiatura programowa. W przypadku tego zdarzenia cancellable = false
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
relatedObjectVal | Odniesienie do listy obiektów ekranowych powiązanej ze zdarzeniem. |
triggerTypeVal | Określa, czy zdarzenie klawiatury zostało wywołane przez aplikację, czy przez użytkownika. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
softKeyboardActivating | Zdarzenie |
flash.events.SoftKeyboardEvent
właściwość SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane przed włączeniem klawiatury programowej, na przykład gdy obiekt StageText stanie się aktywny.
StałaSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
definiuje wartość właściwości type
obiektu SoftKeyboardEvent bezpośrednio przed wyświetleniem klawiatury programowej. W przypadku tego zdarzenia cancellable = true
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | Wartość true , chyba że zdarzenie zostanie wywołane przez obiekt StageText. W przypadku obiektów StageText tego zdarzenia nie można anulować. |
relatedObjectVal | Odniesienie do listy obiektów ekranowych powiązanej ze zdarzeniem. |
triggerTypeVal | Określa, czy zdarzenie klawiatury zostało wywołane przez aplikację, czy przez użytkownika. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
softKeyboardDeactivate | Zdarzenie |
flash.events.SoftKeyboardEvent
właściwość SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane po wyłączeniu klawiatury programowej, na przykład gdy obiekt StageText przestanie być aktywny.
StałaSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
definiuje wartość właściwości type
obiektu SoftKeyboardEvent, gdy jest opuszczona lub ukryta klawiatura programowa. W przypadku tego zdarzenia cancellable = false
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
relatedObjectVal | Odniesienie do listy obiektów ekranowych powiązanej ze zdarzeniem. |
triggerTypeVal | Określa, czy zdarzenie klawiatury zostało wywołane przez aplikację, czy przez użytkownika. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
Tue Jun 12 2018, 12:06 PM Z