Pakiet | fl.controls |
Klasa | public class TextInput |
Dziedziczenie | TextInput UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Implementuje | IFocusManagerComponent |
Podklasy | DataGridCellEditor |
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Składnik TextInput może być włączony lub wyłączony w aplikacji. Po wyłączeniu składnika TextInput nie może on odbierać danych wejściowych z myszy ani klawiatury. Włączony składnik TextInput implementuje aktywację, wybór i nawigację podobnie jak obiekt TextField języka ActionScript.
Można dostosować składnik TextInput za pomocą stylów, zmieniając jego wygląd — na przykład po jego wyłączeniu. Niektóre inne, możliwe do zastosowania zmiany parametrów domyślnych składnika to formatowanie za pomocą kodu HTML lub ustawienie pola jako hasła — wówczas tekst wprowadzany do tego pola jest ukryty.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Bieżąca implementacja dostępności (AccessibilityImplementation) dla tego wystąpienia klasy InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Bieżące opcje dostępności tego obiektu wyświetlanego. | DisplayObject | ||
alpha : Number
Wartość przezroczystości alfa określonego obiektu. | DisplayObject | ||
alwaysShowSelection : Boolean
Pobiera lub ustawia wartość typu Boolean wskazującą sposób wyświetlania zaznaczonych elementów, gdy pole nie jest uaktywnione. | TextInput | ||
blendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć. | DisplayObject | ||
blendShader : Shader [tylko do zapisu]
Ustawia moduł cieniujący, który jest używany do mieszania pierwszego planu oraz tła. | DisplayObject | ||
buttonMode : Boolean
Określa tryb przycisku tej ikonki. | Sprite | ||
cacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
W przypadku wartości innej niż null ten obiekt Matrix definiuje sposób renderowania obiektu wyświetlanego, gdy cacheAsBitmap jest ustawione na true. | DisplayObject | ||
condenseWhite : Boolean
Pobiera lub ustawia wartość typu Boolean wskazującą, czy usuwane są dodatkowe odstępy ze składnika TextInput zawierającego tekst HTML. | TextInput | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
contextMenu : NativeMenu
Określa menu kontekstowe tego obiektu. | InteractiveObject | ||
displayAsPassword : Boolean
Pobiera lub ustawia wartość typu Boolean wskazującą, czy bieżącą instancję składnika TextInput utworzono z myślą o wprowadzaniu hasła, czy zwykłego tekstu. | TextInput | ||
doubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia). | InteractiveObject | ||
dropTarget : DisplayObject [tylko do odczytu]
Określa obiekt ekranowy, nad którym jest przeciągana ikonka, lub na który upuszczono ikonkę. | Sprite | ||
editable : Boolean
Pobiera lub ustawia wartość typu Boolean wskazującą, czy pole tekstowe może być edytowane przez użytkownika. | TextInput | ||
enabled : Boolean [przesłanianie]
Pobiera lub ustawia wartość wskazującą, czy składnik akceptuje interakcje ze strony użytkownika. | TextInput | ||
filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | DisplayObject | ||
focusEnabled : Boolean
Pobiera lub ustawia wartość Boolean określającą, czy składnik może stawać się aktywny, gdy użytkownik go kliknie. | UIComponent | ||
focusManager : IFocusManager
Pobiera lub ustawia obiekt FocusManager sterujący aktywnością tego składnika i jego składników równorzędnych. | UIComponent | ||
focusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności. | InteractiveObject | ||
graphics : Graphics [tylko do odczytu]
Określa obiekt Graphics skojarzony z ikonką, której mogą dotyczyć polecenia rysowania kształtów wektorowych. | Sprite | ||
height : Number [przesłanianie]
Pobiera lub ustawia wysokość składnika w pikselach. | UIComponent | ||
hitArea : Sprite
Określa ikonkę, która ma pełnić funkcję obszaru naciskania innej ikonki. | Sprite | ||
horizontalScrollPosition : int
Pobiera lub ustawia położenie uchwytu poziomego paska przewijania. | TextInput | ||
htmlText : String
Zawiera reprezentację HTML ciągu znaków zawartego w polu tekstowym. | TextInput | ||
imeMode : String
Pobiera lub ustawia tryb edytora IME. | TextInput | ||
length : int [tylko do odczytu]
Pobiera liczbę znaków w składniku TextInput. | TextInput | ||
loaderInfo : LoaderInfo [tylko do odczytu]
Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany. | DisplayObject | ||
mask : DisplayObject
Wywoływany obiekt wyświetlany jest maskowany przez określony obiekt maski. | DisplayObject | ||
maxChars : int
Pobiera lub ustawia maksymalną liczbę znaków, jaką użytkownik może wprowadzić w polu tekstowym. | TextInput | ||
maxHorizontalScrollPosition : int [tylko do odczytu]
Pobiera wartość opisującą najdalsze położenie po prawej stronie, do którego można przewinąć pole tekstowe. | TextInput | ||
metaData : Object
Pobiera obiekt metadanych wystąpienia klasy DisplayObject, jeśli metadane są przechowywane razem z tym wystąpieniem klasy DisplayObject w pliku SWF, korzystając ze znacznika PlaceObject4. | DisplayObject | ||
mouseChildren : Boolean
Określa, czy elementy potomne obiektu obsługują mysz lub inne urządzenie wejściowe użytkownika. | DisplayObjectContainer | ||
mouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. | InteractiveObject | ||
mouseFocusEnabled : Boolean
Pobiera lub ustawia wartość określającą, czy składnik może stawać się aktywny, gdy użytkownik go kliknie. | UIComponent | ||
mouseX : Number [tylko do odczytu]
Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | ||
mouseY : Number [tylko do odczytu]
Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach. | DisplayObject | ||
name : String
Nazwa instancji obiektu DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Określa, czy klawiatura wirtualna (klawiatura programowa wyświetlana na ekranie) powinna być wyświetlana, gdy to wystąpienie klasy InteractiveObject staje się aktywne. | InteractiveObject | ||
numChildren : int [tylko do odczytu]
Zwraca liczbę elementów potomnych tego obiektu. | DisplayObjectContainer | ||
opaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty. | DisplayObject | ||
parent : DisplayObjectContainer [tylko do odczytu]
Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany. | DisplayObject | ||
restrict : String
Pobiera lub ustawia ciąg akceptowanych znaków w polu tekstowym podczas wprowadzania danych przez użytkownika. | TextInput | ||
root : DisplayObject [tylko do odczytu]
Dla obiektu wyświetlanego w załadowanym pliku SWF główną właściwość stanowi obiekt wyświetlany na samym szczycie na liście wyświetlania w postaci struktury drzewa, którą reprezentuje plik SWF. | DisplayObject | ||
rotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach). | DisplayObject | ||
rotationX : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi x — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rotationY : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi y — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
rotationZ : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi z — od pozycji początkowej względem nadrzędnego kontenera 3D. | DisplayObject | ||
scale9Grid : Rectangle
Aktualnie stosowana siatka skalowania. | DisplayObject | ||
scaleX : Number [przesłanianie]
Mnoży bieżącą szerokość składnika przez współczynnik skalowania. | UIComponent | ||
scaleY : Number [przesłanianie]
Mnoży bieżącą wysokość składnika przez współczynnik skalowania. | UIComponent | ||
scaleZ : Number
Wskazuje skalę głębokości (procent) obiektu względem punktu odniesienia. | DisplayObject | ||
scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | DisplayObject | ||
selectionBeginIndex : int [tylko do odczytu]
Pobiera indeks pierwszego spośród zaznaczonych znaków. | TextInput | ||
selectionEndIndex : int [tylko do odczytu]
Pobiera indeks ostatniego spośród zaznaczonych znaków. | TextInput | ||
softKeyboard : String
Steruje wyglądem klawiatury programowej. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definiuje obszar, który powinien pozostać na ekranie po wyświetleniu klawiatury programowej (niedostępna w systemie iOS). | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
Kontroluje dźwięki skojarzone z tą ikonką. | Sprite | ||
stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | DisplayObject | ||
tabChildren : Boolean
Określa, czy elementy potomne tego obiektu mają reagować na klawisz Tab. | DisplayObjectContainer | ||
tabEnabled : Boolean
Określa, czy do tego obiektu można przejść za pomocą klawisza Tab. | InteractiveObject | ||
tabIndex : int
Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. | InteractiveObject | ||
text : String
Pobiera lub ustawia ciąg znaków zawierający tekst, który znajduje się obecnie w składniku TextInput. | TextInput | ||
textField : flash.text:TextField
Odwołanie do wewnętrznego pola tekstowego składnika TextInput. | TextInput | ||
textHeight : Number [tylko do odczytu]
Wysokość tekstu w pikselach. | TextInput | ||
textSnapshot : flash.text:TextSnapshot [tylko do odczytu]
Zwraca obiekt TextSnapshot dla tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | ||
textWidth : Number [tylko do odczytu]
Szerokość tekstu w pikselach. | TextInput | ||
transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | DisplayObject | ||
useHandCursor : Boolean
Wartość typu Boolean wskazuje, czy wskaźnik dłoni pojawia się w momencie, gdy wskaźnik jest przesuwany nad ikonką, której właściwość buttonMode jest ustawiona na wartość true. | Sprite | ||
visible : Boolean [przesłanianie]
Pobiera lub ustawia wartość wskazującą, czy bieżąca instancja składnika jest widoczna. | UIComponent | ||
width : Number [przesłanianie]
Pobiera lub ustawia szerokość składnika w pikselach. | UIComponent | ||
x : Number [przesłanianie]
Pobiera lub ustawia współrzędną x reprezentującą pozycję składnika wzdłuż osi x w jego kontenerze nadrzędnym. | UIComponent | ||
y : Number [przesłanianie]
Pobiera lub ustawia współrzędną y reprezentującą pozycję składnika wzdłuż osi y w jego kontenerze nadrzędnym. | UIComponent | ||
z : Number
Wskazuje współrzędną wzdłuż osi Z instancji DisplayObject względem nadrzędnego kontenera 3D. | DisplayObject |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Tworzy nowe wystąpienie składnika TextInput. | TextInput | ||
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | ||
Dodaje potomne wystąpienie klasy DisplayObject do tego wystąpienia klasy DisplayObjectContainer. | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | ||
Dołącza podany ciąg znaków za ostatnim znakiem zawartym w składniku TextArea. | TextInput | ||
Wskazuje, czy ograniczenia ze względów bezpieczeństwa będą powodowały pomijanie obiektów wyświetlanych na liście uzyskanej poprzez wywołanie metody DisplayObjectContainer.getObjectsUnderPoint() z określonym punktem. | DisplayObjectContainer | ||
Usuwa właściwość stylu z tego wystąpienia składnika. | UIComponent | ||
Decyduje o tym, czy określony obiekt ekranowy jest potomkiem instancji obiektu DisplayObjectContainer, czy też sam jest taką instancją. | DisplayObjectContainer | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
[przesłanianie]
Wyświetla lub ukrywa wskaźnik aktywności tego składnika. | TextInput | ||
Inicjuje natychmiastową operację rysowania bez unieważniania wszystkich składników i właściwości, co odróżnia ją od metody invalidateNow. | UIComponent | ||
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace). | DisplayObject | ||
Zwraca instancję podrzędnego obiektu wyświetlanego o podanym indeksie. | DisplayObjectContainer | ||
Zwraca instancję podrzędnego obiektu wyświetlanego o podanej nazwie. | DisplayObjectContainer | ||
Zwraca indeks podrzędnej instancji DisplayObject. | DisplayObjectContainer | ||
Pobiera obiekt, który jest w danej chwili aktywny. | UIComponent | ||
Pobiera informacje o określonym wierszu tekstu. | TextInput | ||
Zwraca tablicę obiektów, które leżą poniżej określonego punktu i są obiektami podrzędnymi tej instancji obiektu DisplayObjectContainer. | DisplayObjectContainer | ||
Zwraca prostokąt definiujący granice obiektu wyświetlanego w układzie współrzędnych określonych przez parametr targetCoordinateSpace (z wyłączeniem konturów kształtów). | DisplayObject | ||
Pobiera właściwość stylu ustawioną w łańcuchu wyszukiwania stylów danego składnika. | UIComponent | ||
[statyczny]
Pobiera domyślną mapę stylów dla bieżącego składnika. | TextInput | ||
Konwertuje obiekt punktowy ze współrzędnych obiektu Stage (globalne) do współrzędnych obiektu wyświetlanego (lokalne). | DisplayObject | ||
Konwertuje punkt dwuwymiarowy ze współrzędnych stołu wymiarowego (globalnych) na współrzędne trójwymiarowego obiektu wyświetlanego (lokalne). | DisplayObject | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wyznacza prostokąt ograniczający obiekt wyświetlany w celu sprawdzenia, czy zachodzi on lub przecina się z prostokątem ograniczającym obiektu wyświetlanego obj. | DisplayObject | ||
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y. | DisplayObject | ||
Oznacza właściwość jako nieważną i ponownie rysuje składnik w następnej klatce, o ile nie określono innego zachowania. | UIComponent | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Konwertuje punkt trójwymiarowy trójwymiarowego obiektu wyświetlanego (lokalnego) na punkt dwuwymiarowy we współrzędnych stołu montażowego (globalnych). | DisplayObject | ||
Konwertuje obiekt punktowy ze współrzędnych obiektu wyświetlanego (lokalne) do współrzędnych obiektu Stage (globalne). | DisplayObject | ||
[statyczny]
Scala style z wielu klas w jeden obiekt. | UIComponent | ||
Przemieszcza składnik do określonej pozycji w jego obiekcie nadrzędnym. | UIComponent | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa określoną instancję obiektu podrzędnego DisplayObject z listy obiektów podrzędnych instancji DisplayObjectContainer. | DisplayObjectContainer | ||
Usuwa obiekt potomny DisplayObject o podanym indeksie z listy elementów potomnych obiektu DisplayObjectContainer. | DisplayObjectContainer | ||
Powoduje usunięcie wszystkich wystąpień potomnych klasy DisplayObject z listy obiektów potomnych wystąpień klasy DisplayObjectContainer. | DisplayObjectContainer | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Powoduje uniesienie klawiatury wirtualnej. | InteractiveObject | ||
Zmienia położenie istniejącego elementu potomnego w kontenerze obiektów ekranowych. | DisplayObjectContainer | ||
Ustawia ten składnik jako aktywny. | UIComponent | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Ustawia zakres wyboru dokonanego w uaktywnionym obszarze tekstu. | TextInput | ||
Ustawia szerokość i wysokość składnika na określone wartości. | UIComponent | ||
Ustawia właściwość stylu tej instancji składnika. | UIComponent | ||
Pozwala użytkownikowi przeciągnąć określoną ikonkę. | Sprite | ||
Umożliwia użytkownikowi przeciąganie określonej ikonki na urządzeniu z ekranem dotykowym. | Sprite | ||
Rekurencyjnie zatrzymuje wykonywanie osi czasu wszystkich obiektów MovieClip, dla których ten obiekt jest obiektem głównym. | DisplayObjectContainer | ||
Kończy metodę startDrag(). | Sprite | ||
Kończy działanie metody startTouchDrag(); używana z urządzeniami wyposażonymi w ekran dotykowy. | Sprite | ||
Zamienia kolejność dwóch określonych obiektów podrzędnych. | DisplayObjectContainer | ||
Zamienia miejscami na liście dwa różne obiekty potomne o podanych indeksach. | DisplayObjectContainer | ||
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 | ||
Sprawdza ważność i aktualizuje właściwości oraz układ tego obiektu, w razie potrzeby rysując go ponownie. | UIComponent | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
---|---|---|---|---|
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | |||
Wywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania. | DisplayObject | |||
Wywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania na scenie — albo bezpośrednio, albo wskutek dodania poddrzewa zawierającego obiekt wyświetlany. | DisplayObject | |||
Wywoływane, gdy w wyniku działań użytkownika zmieni się tekst składnika TextInput. | TextInput | |||
Wywoływane, gdy użytkownik wybierz opcje „Wyczyść” (lub „Usuń”) z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane w momencie naciśnięcia i zwolnienia głównego przycisku urządzenia wskazującego przez użytkownika na tej samej instancji InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy w wyniku gestu użytkownika zostanie uaktywnione menu kontekstowe skojarzone z tym obiektem interaktywnym w aplikacji AIR. | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację kopiowania lub wybiera polecenie Kopiuj z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wycięcia lub wybiera polecenie Wytnij z menu kontekstowego dla tekstu. | InteractiveObject | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Wywoływane w momencie, gdy użytkownik naciska i zwalnia główny przycisk urządzenia wskazującego dwukrotnie w krótkim odstępie czasu nad tym samym obiektem InteractiveObject, podczas gdy flaga doubleClickEnabled obiektu jest ustawiona na wartość true. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie klawisz Enter. | TextInput | |||
[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania przechodzi do nowej klatki. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania kończy odtwarzanie bieżącej klatki. | DisplayObject | |||
Wywoływane po uaktywnieniu obiektu wyświetlanego. | InteractiveObject | |||
Dysponowana, gdy obiekt ekranowy przestaje być aktywny. | InteractiveObject | |||
[zdarzenie broadcast] Wywoływane po zadziałaniu konstruktorów obiektów wyświetlanych klatek, ale przed działaniem skryptów klatek. | DisplayObject | |||
Zostaje rozesłane, gdy użytkownik utworzy punkt styku wzdłuż krawędzi powierzchni dotykowej z instancją obiektu InteractiveObject (np. dotknięcie wzdłuż krawędzi powierzchni dotykowej pilota Siri Remote do telewizora firmy Apple). Niektóre urządzenia mogą również interpretować taki styk, jako kombinację różnych zdarzeń dotykowych. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie na dwa punkty kontaktu nad tą samą instancją klasy InteractiveObject na urządzeniu dotykowym (np. naciśnie dwoma palcami i zwolni obiekt wyświetlany na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa punkt kontaktu nad wystąpieniem klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przesuwanie palców z lewej strony na prawą nad obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest obrotu w punkcie kontaktu z instancją klasy InteractiveObject (np. dotknie obiektu wyświetlanego dwoma palcami i obróci palce na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest machnięcia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie trzema złączonymi palcami ekranu, a następnie szybkie przesunięcie ich nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik utworzy punkt kontaktu z instancją obiektu InteractiveObject, a następnie stuknie w urządzenie dotykowe (np. przyłoży kilka palców do obiektu wyświetlanego w celu otwarcia menu, a następnie stuknie jednym palcem, aby wybrać element menu na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik wykona gest powiększenia w punkcie kontaktu na instancji obiektu InteractiveObject (np. dotknięcie dwoma palcami ekranu, a następnie szybkie rozsunięcie palców nad obiektem wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane po zmianie stanu widoczności składnika z widocznego na niewidoczny. | UIComponent | |||
To zdarzenie jest wywoływane w każdej aplikacji klienckiej, która obsługuje lokalne wprowadzanie znaków za pomocą edytora IME. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie klawisz. | InteractiveObject | |||
Dysponowana, gdy użytkownik próbuje uaktywnić inny element za pomocą klawiatury. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni klawisz. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie i zwolni środkowy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie środkowy przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik próbuje uaktywnić inny element za pomocą urządzenia wskazującego. | InteractiveObject | |||
Dysponowana, gdy użytkownik ustawi kursor nad instancją obiektu InteractiveObject i poruszy urządzenie wskazujące. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor poza instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Dysponowana, gdy użytkownik przesunie kursor nad instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy kółko myszy zostanie obrócone nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane po przemieszczeniu składnika. | UIComponent | |||
Wywoływane przez obiekt InteractiveObject inicjujący przeciąganie, gdy użytkownik zwolni przycisk podczas przeciągania. | InteractiveObject | |||
Wywoływane przez docelowy obiekt InteractiveObject, gdy przeciągany obiekt zostanie na niego upuszczony i upuszczenie zostanie zaakceptowane wywołaniem DragManager.acceptDragDrop(). | InteractiveObject | |||
Wywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik wchodzi w granice tego obiektu. | InteractiveObject | |||
Wywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik opuści granice tego obiektu. | InteractiveObject | |||
Regularnie wywoływane przez obiekt InteractiveObject, gdy wskaźnik podczas przeciągania pozostaje w granicach tego obiektu. | InteractiveObject | |||
Wywoływane na początku operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag(). | InteractiveObject | |||
Wywoływane podczas operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag(). | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację wklejenia lub wybiera polecenie Wklej z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane, gdy użytkownik opuści aktywny pisak na odległość mniejszą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik uniesie aktywny pisak na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak nad ekranem, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak poza dany obiekt InteractiveObject, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak bezpośrednio nad danym obiektem InteractiveObject, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak poza obiekt InteractiveObject i jego obiekty potomne, przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna odległość wykrywania dla ekranu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa aktywny pisak z obszaru poza drzewem obiektów potomnych danego obiektu InteractiveObject na liście wyświetlania nad ten obiekt (przy czym pisak nie zostaje uniesiony na odległość większą niż graniczna wartość wykrywania dla ekranu). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwalnia przycisk urządzenia wskazującego, jeśli wcześniej nacisnął ten przycisk na wystąpieniu klasy InteractiveObject i przesunął wskaźnik urządzenia poza to wystąpienie klasy InteractiveObject. | InteractiveObject | |||
Dysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania. | DisplayObject | |||
Dysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania na scenie — albo bezpośrednio, albo wskutek usunięcia poddrzewa zawierającego obiekt ekranowy. | DisplayObject | |||
[zdarzenie broadcast] Wywoływane, gdy lista wyświetlania ma być aktualizowana lub renderowana. | DisplayObject | |||
Wywoływane po zmianie rozmiaru składnika. | UIComponent | |||
Wywoływane, gdy użytkownik naciśnie i zwolni prawy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor poza wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesunie kursor nad wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego). | InteractiveObject | |||
Wywoływane, gdy użytkownik uaktywnia specyficzną dla platformy kombinację klawiszy wywołującą operację zaznaczenia wszystkiego lub wybiera polecenie „Zaznacz wszystko” z menu kontekstowego dla tekstu. | InteractiveObject | |||
Wywoływane po zmianie stanu widoczności składnika z niewidocznego na widoczny. | UIComponent | |||
Wywoływane bezpośrednio po uniesieniu klawiatury programowej. | InteractiveObject | |||
Wywoływane bezpośrednio przed uniesieniem klawiatury programowej. | InteractiveObject | |||
Wywoływane bezpośrednio po opuszczeniu klawiatury programowej. | InteractiveObject | |||
Wywoływane, gdy zmienia się wartość flagi tabChildren obiektu. | InteractiveObject | |||
Wywoływane, gdy zmienia się flaga tabEnabled obiektu. | InteractiveObject | |||
Wywoływane, gdy zmienia się wartość właściwości tabIndex obiektu. | InteractiveObject | |||
Wywoływane, gdy użytkownik wprowadzi tekst. | TextInput | |||
Wywoływane, gdy użytkownik zainicjuje kontakt z urządzeniem dotykowym (np. dotknie palcem ekranu dotykowego telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przerwie kontakt z urządzeniem dotykowym (np. uniesie palec z ekranu dotykowego telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik dotyka urządzenia. Wywołanie jest powtarzane w sposób ciągły do momentu usunięcia punktu kontaktu. | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu od instancji klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z jednego obiektu wyświetlanego do punktu na drugim obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu nad instancję klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z punktu poza obiektem wyświetlanym do punktu na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik przesuwa punkt kontaktu poza wystąpienie klasy InteractiveObject na urządzeniu dotykowym (na przykład przez przeciągnięcie palcem znad obiektu ekranowego do punktu poza obiektem ekranowym na telefonie komórkowym lub tablecie z ekranem dotykowym). | InteractiveObject | |||
Wywoływane, gdy użytkownik przemieści punkt kontaktu nad instancję klasy InteractiveObject na urządzeniu dotykowym (np. przeciągnie palcem z punktu poza obiektem wyświetlanym do punktu na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject | |||
Wywoływane, gdy użytkownik zwolni nacisk na ekran dotykowy w punkcie kontaktu na tej samej instancji klasy InteractiveObject, na której kontakt został zainicjowany (na przykład naciśnie palcem i zwolni pojedynczy punkt na obiekcie wyświetlanym na ekranie dotykowym telefonu komórkowego lub tabletu). | InteractiveObject |
Wyróżnia się style wspólne i powiązane z konkretnymi motywami. Styl wspólny może być używany z dowolnym motywem. Styl powiązany z konkretnym motywem może być używany pod warunkiem, że w aplikacji jest używany właśnie ten motyw.
Styl | Opis | Zdefiniowane przez | ||
---|---|---|---|---|
disabledSkin | Typ: Class Wersja języka: ActionScript 3.0 Wersja produktu: Flash CS3 Wersje środowiska wykonawczego: Flash9.0.28.0, AIR 1.0 Nazwa klasy, która będzie używana jako tło dla składnika TextInput po ustawieniu jej właściwości enabled na wartość false .
Wartością domyślną jest TextInput_disabledSkin . | TextInput | ||
Typ: flash.text.TextFormat Wersja języka: ActionScript 3.0 Wersja produktu: Flash CS3 Wersje środowiska wykonawczego: Flash9.0.28.0, AIR 1.0 Obiekt TextFormat, który ma być używany do renderowania etykiety składnika, gdy przycisk jest wyłączony. | UIComponent | |||
embedFonts | Typ: Boolean Wersja języka: ActionScript 3.0 Wersja produktu: Flash CS3 Wersje środowiska wykonawczego: Flash9.0.28.0, AIR 1.0 Wskazuje, czy do renderowania tego pola tekstowego są używane osadzone kontury czcionek. Jeśli wartością jest true , program Flash Player renderuje pole tekstowe za pomocą osadzonych konturów czcionek. Jeśli wartością jest false , program Flash Player renderuje pole tekstowe za pomocą czcionek urządzenia.
Ustawienie właściwości false . | TextInput | ||
Typ: Number Format: Length Wersja języka: ActionScript 3.0 Wersja produktu: Flash CS3 Wersje środowiska wykonawczego: Flash9.0.28.0, AIR 1.0 Wypełnienie, które oddziela zewnętrzne granice składnika od zewnętrznych krawędzi wskaźnika aktywności, w pikselach. | UIComponent | |||
Typ: Class Wersja języka: ActionScript 3.0 Wersja produktu: Flash CS3 Wersje środowiska wykonawczego: Flash9.0.28.0, AIR 1.0 Karnacja, która ma być używana do wyświetlania wskaźników aktywności. | UIComponent | |||
Typ: flash.text.TextFormat Wersja języka: ActionScript 3.0 Wersja produktu: Flash CS3 Wersje środowiska wykonawczego: Flash9.0.28.0, AIR 1.0 Obiekt TextFormat, który ma być używany do renderowania etykiety składnika. | UIComponent | |||
textPadding | Typ: Number Format: Length Wersja języka: ActionScript 3.0 Wersja produktu: Flash CS3 Wersje środowiska wykonawczego: Flash9.0.28.0, AIR 1.0 Wypełnienie (w pikselach) oddzielające obramowanie składnika od tekstu. Wartością domyślną jest 0 . | TextInput | ||
upSkin | Typ: Class Wersja języka: ActionScript 3.0 Wersja produktu: Flash CS3 Wersje środowiska wykonawczego: Flash9.0.28.0, AIR 1.0 Nazwa klasy, która będzie używana jako tło dla składnika TextInput. Wartością domyślną jest TextInput_upSkin . | TextInput |
alwaysShowSelection | właściwość |
alwaysShowSelection:Boolean
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia wartość typu Boolean wskazującą sposób wyświetlania zaznaczonych elementów, gdy pole nie jest uaktywnione.
Jeśli ta wartość to true
, a pole tekstowe nie zostało uaktywnione, program Flash Player wyróżnia zaznaczenie kolorem szarym. Jeśli tę wartość ustawiono na false
, a pole tekstowe nie zostało uaktywnione, program Flash Player nie wyróżnia zaznaczenia.
Wartością domyślną jest false.
Implementacja
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
Przykład ( Sposób korzystania z tego przykładu )
setSelection()
:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
condenseWhite | właściwość |
condenseWhite:Boolean
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia wartość typu Boolean wskazującą, czy usuwane są dodatkowe odstępy ze składnika TextInput zawierającego tekst HTML. Przykłady dodatkowych odstępów obejmują spacje i podziały wierszy. Wartość true
oznacza, że dodatkowy odstęp jest usuwany; wartość false
oznacza sytuację przeciwną.
Właściwość ta ma wpływ wyłącznie na tekst ustawiony za pomocą właściwości htmlText
; nie ma on wpływu na tekst ustawiony za pośrednictwem właściwości text
. W przypadku korzystania z właściwości text
do ustawiania tekstu właściwość condenseWhite
jest ignorowana.
Jeśli właściwość condenseWhite
zostanie ustawiona na wartość true
, konieczne jest użycie standardowych poleceń HTML, takich jak <br> i <p>, w celu umieszczenia podziałów wierszy w polu tekstowym.
Wartością domyślną jest false.
Implementacja
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
Powiązane elementy interfejsu API
displayAsPassword | właściwość |
displayAsPassword:Boolean
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia wartość typu Boolean wskazującą, czy bieżącą instancję składnika TextInput utworzono z myślą o wprowadzaniu hasła, czy zwykłego tekstu. Wartość true
wskazuje, że instancja składnika jest polem tekstowym wprowadzania hasła; wartość false
wskazuje, że instancja składnika jest zwykłym polem tekstowym.
W przypadku ustawienia tej właściwości na wartość true
dla każdego wprowadzonego przez użytkownika do pola tekstowego znaku w instancji składnika TextInput jest wyświetlany symbol gwiazdki. Dodatkowo w polu tym zostaną wyłączone polecenia Wytnij i Wklej oraz odpowiednie skróty klawiaturowe. Ma to na celu uniemożliwienie pozyskania hasła po chwilowym odejściu użytkownika od komputera.
Wartością domyślną jest false.
Implementacja
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
displayAsPassword
ustawioną na wartość true
, druga zaś na wartość false
:
import fl.controls.Label; import fl.controls.TextInput; var usernameLabel:Label = new Label(); usernameLabel.text = "User name:"; usernameLabel.move(10, 10); addChild(usernameLabel); var usernameTextInput:TextInput = new TextInput(); usernameTextInput.move(90, 10); addChild(usernameTextInput); var passwordLabel:Label = new Label(); passwordLabel.text = "Password:"; passwordLabel.move(10, 40); addChild(passwordLabel); var passwordTextInput:TextInput = new TextInput(); passwordTextInput.displayAsPassword = true; passwordTextInput.move(90, 40); addChild(passwordTextInput);
editable | właściwość |
editable:Boolean
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia wartość typu Boolean wskazującą, czy pole tekstowe może być edytowane przez użytkownika. Wartość true
wskazuje, że użytkownik może edytować pole tekstowe; wartość false
oznacza sytuację przeciwną.
Wartością domyślną jest true.
Implementacja
public function get editable():Boolean
public function set editable(value:Boolean):void
enabled | właściwość |
enabled:Boolean
[przesłanianie] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia wartość wskazującą, czy składnik akceptuje interakcje ze strony użytkownika. Wartość true
oznacza, że składnik może akceptować interakcje ze strony użytkownika; wartość false
oznacza sytuację przeciwną.
Ustawienie właściwości enabled
na false
powoduje, że kolor kontenera zostanie wyszarzony, a akceptowanie interakcji ze strony użytkownika będzie zablokowane (z wyjątkiem składników Label i ProgressBar).
Implementacja
override public function get enabled():Boolean
override public function set enabled(value:Boolean):void
horizontalScrollPosition | właściwość |
horizontalScrollPosition:int
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia położenie uchwytu poziomego paska przewijania.
Wartością domyślną jest 0.
Implementacja
public function get horizontalScrollPosition():int
public function set horizontalScrollPosition(value:int):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
horizontalScrollPosition
i maxHorizontalScrollPosition
:
import fl.controls.Label; import fl.controls.Slider; import fl.controls.TextInput; import fl.events.SliderEvent; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.width = 120; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, textInputChangeHandler); myTextInput.textField.addEventListener(Event.SCROLL, scrollHandler); addChild(myTextInput); var mySlider:Slider = new Slider(); mySlider.snapInterval = 1; mySlider.tickInterval = 10; mySlider.minimum = 0; mySlider.maximum = myTextInput.maxHorizontalScrollPosition; mySlider.value = myTextInput.horizontalScrollPosition; mySlider.liveDragging = true; mySlider.addEventListener(SliderEvent.CHANGE, sliderChangeHandler); mySlider.width = 120; mySlider.move(10, 40); addChild(mySlider); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = ""; myLabel.move(10, 50); addChild(myLabel); getScrollPosition(); function getScrollPosition():void { myTextInput.drawNow(); var scrollPos:uint = myTextInput.horizontalScrollPosition; var maxScrollPos:uint = myTextInput.maxHorizontalScrollPosition; myLabel.text = "scrollPosition: " + scrollPos + " of " + maxScrollPos; mySlider.value = scrollPos; mySlider.maximum = maxScrollPos; } function scrollHandler(event:Event):void { getScrollPosition(); } function sliderChangeHandler(event:SliderEvent):void { myTextInput.horizontalScrollPosition = event.value; getScrollPosition(); } function textInputChangeHandler(event:Event):void { getScrollPosition(); }
htmlText | właściwość |
htmlText:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Zawiera reprezentację HTML ciągu znaków zawartego w polu tekstowym.
Wartością domyślną jest "".
Implementacja
public function get htmlText():String
public function set htmlText(value:String):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
htmlText
w celu zastosowania formatowania HTML do tekstu znajdującego się w polu tekstowym:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.editable = false; myTextInput.enabled = false; myTextInput.htmlText = "(<i>auto assigned</i>)"; myTextInput.move(10, 10); addChild(myTextInput);
imeMode | właściwość |
imeMode:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia tryb edytora IME. Edytor IME umożliwia użytkownikom wprowadzanie za pośrednictwem klawiatury QWERTY znaków należących do chińskiego, japońskiego oraz koreańskiego zestawu znaków.
Edytor IME jest przełączany do podanego trybu po uaktywnieniu składnika, a pierwotny tryb jest przywracany po jego dezaktywacji.
Klasa flash.system.IMEConversionMode definiuje stałe dla poprawnych wartości tej właściwości. Właściwość tę należy ustawić na wartość null
, aby uniknąć użycia edytora IME wraz ze składnikiem.
Implementacja
public function get imeMode():String
public function set imeMode(value:String):void
length | właściwość |
length:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera liczbę znaków w składniku TextInput.
Wartością domyślną jest 0.
Implementacja
public function get length():int
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
maxChars
i restrict
w celu ograniczenia liczby znaków możliwych do wprowadzenia:
import fl.controls.Label; import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "0-9A-F"; myTextInput.maxChars = 6; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; myLabel.move(10, 30); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; }
maxChars | właściwość |
maxChars:int
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia maksymalną liczbę znaków, jaką użytkownik może wprowadzić w polu tekstowym.
Wartością domyślną jest 0.
Implementacja
public function get maxChars():int
public function set maxChars(value:int):void
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
maxChars
i restrict
w celu ograniczenia liczby znaków możliwych do wprowadzenia.
import fl.controls.Label; import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.restrict = "0-9A-F"; myTextInput.maxChars = 6; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; myLabel.move(10, 30); addChild(myLabel); function changeHandler(event:Event):void { myLabel.text = myTextInput.length + " of " + myTextInput.maxChars; }
maxHorizontalScrollPosition | właściwość |
maxHorizontalScrollPosition:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera wartość opisującą najdalsze położenie po prawej stronie, do którego można przewinąć pole tekstowe.
Wartością domyślną jest 0.
Implementacja
public function get maxHorizontalScrollPosition():int
Powiązane elementy interfejsu API
restrict | właściwość |
restrict:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia ciąg akceptowanych znaków w polu tekstowym przy wprowadzaniu przez użytkownika znaków. Należy zauważyć, że znaki nieuwzględnione w tym ciągu znaków są akceptowane, o ile zostaną wprowadzone przez program.
Znaki w ciągu znaków są odczytywane od lewej do prawej. Można podać zakres znaków, korzystając z myślnika (-).
Jeśli wartość tej właściwości to null, w polu tekstowym akceptowane są wszystkie znaki. Jeśli tę właściwość ustawiono na pusty ciąg znaków (""), w polu tekstowym nie są akceptowane żadne znaki.
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.
Wartością domyślną jest null.
Implementacja
public function get restrict():String
public function set restrict(value:String):void
Powiązane elementy interfejsu API
selectionBeginIndex | właściwość |
selectionBeginIndex:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera indeks pierwszego spośród zaznaczonych znaków.
Indeks zaznaczonego znaku jest obliczany dla pierwszego znaku wyświetlanego w obszarze tekstowym. W przypadku braku zaznaczenia wartość ta jest przyjmowana dla znaku karetki.
Wartością domyślną jest 0.
Implementacja
public function get selectionBeginIndex():int
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
selectionBeginIndex
i selectionEndIndex
dla składnika TextInput. Ten przykład umożliwia także tworzenie dwu instancji składnika Slider, które mogą być używane do ustawienia indeksu początku zaznaczenia oraz indeksu końca zaznaczenia programowo, za pośrednictwem metody setSelection()
:
import fl.controls.Label; import fl.controls.Slider; import fl.controls.TextInput; import fl.events.SliderEvent; var myTextInput:TextInput = new TextInput(); myTextInput.alwaysShowSelection = true; myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.width = 120; myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); myTextInput.addEventListener(FocusEvent.FOCUS_IN, focusInHandler); myTextInput.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler); addChild(myTextInput); var myLabel:Label = new Label(); myLabel.autoSize = TextFieldAutoSize.LEFT; myLabel.text = ""; myLabel.move(10, 30); addChild(myLabel); var beginSlider:Slider = new Slider(); beginSlider.maximum = myTextInput.length; beginSlider.snapInterval = 1; beginSlider.liveDragging = true; beginSlider.width = 120; beginSlider.move(10, 65); beginSlider.addEventListener(SliderEvent.CHANGE, beginChangeHandler); addChild(beginSlider); var endSlider:Slider = new Slider(); endSlider.maximum = myTextInput.length; endSlider.snapInterval = 1; endSlider.liveDragging = true; endSlider.width = 120; endSlider.move(10, 85); endSlider.addEventListener(SliderEvent.CHANGE, endChangeHandler); addChild(endSlider); var t:Timer = new Timer(50); t.addEventListener(TimerEvent.TIMER, timerHandler); function changeHandler(event:Event):void { beginSlider.maximum = myTextInput.length; endSlider.maximum = myTextInput.length; updateUI(); } function focusInHandler(event:FocusEvent):void { t.start(); } function focusOutHandler(event:FocusEvent):void { t.stop(); } function beginChangeHandler(event:SliderEvent):void { myTextInput.setSelection(event.value, myTextInput.selectionEndIndex); updateUI(); } function endChangeHandler(event:SliderEvent):void { myTextInput.setSelection(myTextInput.selectionBeginIndex, event.value); updateUI(); } function timerHandler(event:TimerEvent):void { updateUI(); } function updateUI():void { myLabel.text = "selectionBeginIndex:" + myTextInput.selectionBeginIndex + "\n"; myLabel.text += "selectionEndIndex:" + myTextInput.selectionEndIndex; beginSlider.value = myTextInput.selectionBeginIndex; endSlider.value = myTextInput.selectionEndIndex; }
selectionEndIndex | właściwość |
selectionEndIndex:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera indeks ostatniego spośród zaznaczonych znaków.
Indeks zaznaczonego znaku jest obliczany dla pierwszego znaku wyświetlanego w obszarze tekstowym. W przypadku braku zaznaczenia wartość ta jest przyjmowana dla znaku karetki.
Wartością domyślną jest 0.
Implementacja
public function get selectionEndIndex():int
Powiązane elementy interfejsu API
text | właściwość |
text:String
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia ciąg znaków zawierający tekst, który znajduje się obecnie w składniku TextInput. Właściwość ta zawiera tekst niesformatowany i niezawierający tagów HTML. W celu pobrania tego tekstu jako sformatowanego tekstu HTML należy użyć właściwości htmlText
.
Wartością domyślną jest "".
Implementacja
public function get text():String
public function set text(value:String):void
Powiązane elementy interfejsu API
textField | właściwość |
public var textField:flash.text:TextField
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Odniesienie do wewnętrznego pola tekstowego składnika TextInput.
Przykład ( Sposób korzystania z tego przykładu )
textField
do uzyskania dostępu do podstawowego, natywnego obiektu TextField języka ActionScript oraz wywołania jego metody replaceText()
:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.textField.replaceText(41, 44, "fox"); myTextInput.textField.replaceText(16, 19, "dog"); addChild(myTextInput);
textHeight | właściwość |
textWidth | właściwość |
textWidth:Number
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Szerokość tekstu w pikselach.
Wartością domyślną jest 0.
Implementacja
public function get textWidth():Number
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
textWidth
i textHeight
za każdym razem, gdy zmieni się zawartość pola tekstowego:
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.move(10, 10); myTextInput.addEventListener(Event.CHANGE, changeHandler); addChild(myTextInput); function changeHandler(event:Event):void { trace("textWidth:" + myTextInput.textWidth + ", textHeight:" + myTextInput.textHeight); }
TextInput | () | Konstruktor |
public function TextInput()
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Tworzy nową instancję składnika TextInput.
appendText | () | metoda |
public function appendText(text:String):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Dołącza podany ciąg znaków za ostatnim znakiem zawartym w składniku TextArea. Metoda ta jest znacznie skuteczniejsza niż konkatenacja dwu ciągów znaków przez przypisanie dołączenia we właściwości text -- na przykład myTextArea.text += moreText
. Metoda ta jest znacznie bardziej użyteczna, gdy składnik TextArea zawiera znaczącą pod względem ilościowym zawartość.
Parametry
text:String — Ciąg znaków, który ma zostać dołączony do istniejącego tekstu.
|
drawFocus | () | metoda |
override public function drawFocus(draw:Boolean):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wyświetla lub ukrywa wskaźnik aktywności tego składnika.
Klasa UIComponent implementuje tę metodę poprzez utworzenie i ustawienie położenia instancji klasy określonej przez styl focusSkin
.
Parametry
draw:Boolean — Wskazuje, czy wskaźnik aktywności ma być wyświetlony, czy ukryty. Jeśli wartość to true , wskaźnik aktywności jest wyświetlany; jeśli wartość to false , wskaźnik aktywności jest ukrywany.
|
getLineMetrics | () | metoda |
public function getLineMetrics(index:int):flash.text:TextLineMetrics
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera informacje o określonym wierszu tekstu.
Parametry
index:int — Numer wiersza, dla którego mają zostać pobrane informacje.
|
flash.text:TextLineMetrics |
Przykład ( Sposób korzystania z tego przykładu )
var format:TextFormat = new TextFormat(); format.size = 72; format.font = "Georgia"; import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.setSize(393,82); ti.move(10,10); ti.setStyle("textFormat",format); ti.text = "Hello World"; ti.drawNow(); var metrics:TextLineMetrics = ti.getLineMetrics(0); var ascenderColoring:Shape = new Shape(); var descenderColoring:Shape = new Shape(); ti.addChild(ascenderColoring); ti.addChild(descenderColoring); ascenderColoring.graphics.clear(); ascenderColoring.graphics.beginFill(0xFF0000,0.2); ascenderColoring.graphics.drawRect(0, 0, metrics.width, metrics.ascent); descenderColoring.graphics.clear(); descenderColoring.graphics.beginFill(0x0000FF,0.2); descenderColoring.graphics.drawRect(0, metrics.ascent + 2, metrics.width, metrics.descent);
getStyleDefinition | () | metoda |
public static function getStyleDefinition():Object
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera domyślną mapę stylów dla bieżącego składnika. Mapa stylów zawiera typ odpowiedni dla składnika, w zależności od stylu składnika. Na przykład dla stylu disabledTextFormat
wartość jest równa null
lub jest obiektem TextFormat. Można używać tych stylów w wywołaniach metody setStyle()
dla bieżącego składnika. Poniższy kod przesłania domyślny styl disabledTextFormat
dla określonego składnika:
componentInstance.setStyle("disabledTextFormat", new TextFormat());
Object — Obiekt o stylach domyślnych.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
import fl.controls.*; import fl.containers.*; import fl.controls.listClasses.*; import fl.controls.dataGridClasses.*; import fl.controls.progressBarClasses.*; import fl.core.UIComponent; import fl.data.DataProvider; var dp:DataProvider = new DataProvider(); dp.addItem( { label: "BaseScrollPane", data:BaseScrollPane } ); dp.addItem( { label: "Button", data:Button } ); dp.addItem( { label: "CellRenderer", data:CellRenderer } ); dp.addItem( { label: "CheckBox", data:CheckBox } ); dp.addItem( { label: "ColorPicker", data:ColorPicker } ); dp.addItem( { label: "ComboBox", data:ComboBox } ); dp.addItem( { label: "DataGrid", data:DataGrid } ); dp.addItem( { label: "HeaderRenderer", data:HeaderRenderer } ); dp.addItem( { label: "ImageCell", data:ImageCell } ); dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } ); dp.addItem( { label: "Label", data:Label } ); dp.addItem( { label: "List", data:List } ); dp.addItem( { label: "NumericStepper", data:NumericStepper } ); dp.addItem( { label: "ProgressBar", data:ProgressBar } ); dp.addItem( { label: "RadioButton", data:RadioButton } ); dp.addItem( { label: "ScrollPane", data:ScrollPane } ); dp.addItem( { label: "Slider", data:Slider } ); dp.addItem( { label: "TextArea", data:TextArea } ); dp.addItem( { label: "TextInput", data:TextInput } ); dp.addItem( { label: "TileList", data:TileList } ); dp.addItem( { label: "UILoader", data:UILoader } ); dp.addItem( { label: "UIComponent", data:UIComponent } ); var cb:ComboBox = new ComboBox(); cb.move(10,10); cb.setSize(300,25); cb.prompt = "Select a component to view its styles"; cb.rowCount = 12; cb.dataProvider = dp; cb.addEventListener(Event.CHANGE, showStyleDefinition); addChild(cb); var dg:DataGrid = new DataGrid(); dg.setSize(425,300); dg.move(10,50); dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ]; addChild(dg); function showStyleDefinition(e:Event):void { var componentClass:Class = e.target.selectedItem.data as Class; var styles:Object = componentClass["getStyleDefinition"].call(this); trace(styles.toString()); var styleData:DataProvider = new DataProvider(); for(var i:* in styles) { trace(i + " : " + styles[i]); styleData.addItem( { StyleName:i, DefaultValue:styles[i] } ); } styleData.sortOn("StyleName"); dg.dataProvider = styleData; }
setSelection | () | metoda |
public function setSelection(beginIndex:int, endIndex:int):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Ustawia zakres wyboru dokonanego w uaktywnionym obszarze tekstu. Zakres wyboru zaczyna się od indeksu określonego parametrem start, a kończy indeksem określonym parametrem end. Jeśli wartości parametrów określających zakres wyboru są takie same, metoda ta ustawia punkt wstawiania tekstu w ten sam sposób, co właściwość caretIndex
.
Wybrany tekst jest traktowany jako ciąg znaków na bazie zera, w którym pierwszy wybrany znak znajduje się pod indeksem 0, drugi pod indeksem 1, itd.
Metoda ta nie odniesie skutku, jeśli pole tekstowe nie będzie aktywne.
Parametry
beginIndex:int — Indeks pierwszego znaku wyboru.
| |
endIndex:int — Indeks ostatniego znaku wyboru.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
import fl.controls.TextInput; var ti:TextInput = new TextInput(); addChild(ti); ti.text = "Hello World"; ti.setFocus(); ti.setSelection(6, 11);
setSelection()
.
import fl.controls.TextInput; var myTextInput:TextInput = new TextInput(); myTextInput.text = "The quick brown fox jumped over the lazy dog."; myTextInput.alwaysShowSelection = true; myTextInput.setSelection(16, 19); myTextInput.move(10, 10); addChild(myTextInput);
change | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.CHANGE
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane, gdy w wyniku działań użytkownika zmieni się tekst składnika TextInput.
Uwaga: To zdarzenie nie ma miejsca, jeśli wartość jest zmieniana za pośrednictwem kodu ActionScript.
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. |
enter | Zdarzenie |
fl.events.ComponentEvent
właściwość ComponentEvent.type =
fl.events.ComponentEvent.ENTER
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane, gdy użytkownik naciśnie klawisz Enter.
Definiuje wartość właściwościtype
obiektu zdarzenia enter
.
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, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości currentTarget . |
textInput | Zdarzenie |
flash.events.TextEvent
właściwość TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS3 |
Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Wywoływane, gdy użytkownik wprowadzi tekst.
Definiuje wartość właściwościtype
obiektu zdarzenia textInput
.
Uwaga: To zdarzenie nie jest wywoływane dla klawiszy Delete ani Backspace.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
cancelable | true ; w celu anulowania zachowania domyślnego należy wywołać metodę preventDefault() . |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Pole tekstowe, do którego wprowadzane są znaki. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
text | Znak lub sekwencja znaków wprowadzonych przez użytkownika. |
- Dodaj składniki TextInput, Label i Button do biblioteki
- Zapisz ten kod pod nazwą TextInputExample.as w tym samym katalogu, co plik FLA.
- Ustaw właściwość DocumentClass w pliku FLA na wartość TextInputExample.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.events.Event; import fl.controls.TextInput; import fl.controls.Label; import fl.controls.Button; public class TextInputExample extends Sprite { private var ti1:TextInput; private var ti2:TextInput; private var label1:Label; private var label2:Label; private var submitBtn:Button; public function TextInputExample() { setupLabels(); setupInputFields(); setupButton(); } private function setupInputFields():void { ti1 = new TextInput(); ti2 = new TextInput(); ti1.move(50,10); ti2.move(50,40); ti2.displayAsPassword = true; ti1.addEventListener(Event.CHANGE, textEntered); ti2.addEventListener(Event.CHANGE, textEntered); addChild(ti1); addChild(ti2); } private function setupLabels():void { label1 = new Label(); label2 = new Label(); label1.move(10,10); label2.move(10,40); label1.text = "User:"; label2.text = "Pass:" addChild(label1); addChild(label2); } private function setupButton():void { submitBtn = new Button(); submitBtn.move(150,70); submitBtn.label = "Go"; submitBtn.enabled = false; submitBtn.setSize(50,20); submitBtn.addEventListener(MouseEvent.CLICK, submitLogin); addChild(submitBtn); } private function textEntered(e:Event):void { if(ti1.text != "" && ti2.text != "") { submitBtn.enabled = true; } else { submitBtn.enabled = false; } } private function submitLogin(e:MouseEvent):void { var submitLabel:Label = new Label(); submitLabel.move(10,70); submitLabel.autoSize = "left"; submitLabel.text = "Login has been submitted." addChild(submitLabel); submitBtn.removeEventListener(MouseEvent.CLICK, submitLogin); } } }
Tue Jun 12 2018, 12:06 PM Z