| Pakiet | flash.display |
| Klasa | public class InteractiveObject |
| Dziedziczenie | InteractiveObject  DisplayObject EventDispatcher Object |
| Podklasy | DisplayObjectContainer, SimpleButton, TextField |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Nie można bezpośrednio utworzyć instancji klasy InteractiveObject. Wywołanie do konstruktora new InteractiveObject() powoduje zgłoszenie wyjątku ArgumentError.
Sama klasa InteractiveObject nie zawiera żadnych interfejsów API do renderowania zawartości na ekranie. Aby utworzyć niestandardową podklasę klasy InteractiveObject, należy rozszerzyć jedną z podklas, które zawierają elementy interfejsu API służące do renderowania treści na ekranie, np. klasę Sprite, SimpleButton, TextField lub MovieClip.
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| 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 | |
| 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 | |
| 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 | |
| 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 | ||
| doubleClickEnabled : Boolean
Określa, czy ten obiekt reaguje na zdarzenia doubleClick (dwukrotne kliknięcia). | InteractiveObject | ||
| filters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym. | DisplayObject | |
| focusRect : Object
Określa, czy z tym obiektem skojarzono ramkę aktywności. | InteractiveObject | ||
| height : Number
Wysokość obiektu ekranowego w pikselach. | DisplayObject | |
| 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 | |
| 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 | |
| mouseEnabled : Boolean
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. | InteractiveObject | ||
| 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 | ||
| 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 | |
| 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
Wskazuje skalę poziomą (procent) obiektu względem punktu odniesienia. | DisplayObject | |
| scaleY : Number
Wskazuje skalę pionową (procent) obiektu względem punktu odniesienia. | DisplayObject | |
| scaleZ : Number
Wskazuje skalę głębokości (procent) obiektu względem punktu odniesienia. | DisplayObject | |
| scrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego. | DisplayObject | |
| 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 | ||
| stage : Stage [tylko do odczytu]
Stół montażowy obiektu wyświetlanego. | DisplayObject | |
| 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 | ||
| transform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli. | DisplayObject | |
| visible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie. | DisplayObject | |
| width : Number
Szerokość obiektu ekranowego w pikselach. | DisplayObject | |
| x : Number
Oznacza współrzędną x instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | DisplayObject | |
| y : Number
Oznacza współrzędną y instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer. | DisplayObject | |
| z : Number
Wskazuje współrzędną wzdłuż osi Z instancji DisplayObject względem nadrzędnego kontenera 3D. | DisplayObject | |
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Wywołanie nowego konstruktora InteractiveObject() skutkuje wyjątkiem ArgumentError. | InteractiveObject | ||
| 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 | |
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
|
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace). | DisplayObject | |
|
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 | |
|
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 | |
|
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 | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
Powoduje uniesienie klawiatury wirtualnej. | InteractiveObject | ||
|
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 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 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 | |||
| [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 | |||
| 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 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, 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 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 jeden lub większą liczbę znaków tekstu. | InteractiveObject | |||
| 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 | |||
accessibilityImplementation | właściwość |
accessibilityImplementation:AccessibilityImplementation| Wersja języka: | ActionScript 3.0 |
Bieżąca implementacja dostępności (AccessibilityImplementation) dla tej instancji klasy InteractiveObject.
Implementacja
public function get accessibilityImplementation():AccessibilityImplementation public function set accessibilityImplementation(value:AccessibilityImplementation):voidPowiązane elementy interfejsu API
contextMenu | właściwość |
contextMenu:NativeMenu| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa menu kontekstowe tego obiektu.
W przypadku treści działającej w programie Flash Player ta właściwość zawiera obiekt ContextMenu. W środowisku AIR klasa ContextMenu rozszerza klasę NativeMenu, jednak program Flash Player obsługuje tylko klasę ContextMenu, a nie klasę NativeMenu.
Uwaga: Menu kontekstowe obiektów TextField zawsze zawiera menu schowka. Menu schowka zawiera polecenia Wytnij, Kopiuj, Wklej, Wyczyść i Zaznacz wszystko. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll.
Implementacja
public function get contextMenu():NativeMenu public function set contextMenu(value:NativeMenu):voidPrzykład ( Sposób korzystania z tego przykładu )
var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
spr.graphics.clear();
spr.graphics.beginFill(0xFF0000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
}
doubleClickEnabled | właściwość |
doubleClickEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa, czy obiekt otrzymuje zdarzenia doubleClick. Domyślna wartość to false co oznacza, iż domyślnie instancja InteractiveObject nie otrzymuje zdarzeń doubleClick. Jeżeli właściwość doubleClickEnabled jest ustawiona na wartość true, wówczas instancja otrzymuje zdarzenia doubleClick wewnątrz swoich granic. Właściwość mouseEnabled instancji InteractiveObject również musi być ustawiona na wartość true, aby obiekt mógł otrzymywać zdarzenia doubleClick.
Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu dodania detektora zdarzeń dla zdarzenia doubleClick.
Implementacja
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voidPowiązane elementy interfejsu API
focusRect | właściwość |
focusRect:Object| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy z tym obiektem skojarzono ramkę aktywności. Może mieć jedną z trzech wartości: true, false lub null. Wartości true i false działają zgodnie z oczekiwaniami; określają one, czy pojawia się prostokąt oznaczający aktywność obiektu. Wartość null oznacza, że ten obiekt jest zgodny z właściwością stageFocusRect stołu montażowego.
Implementacja
public function get focusRect():Object public function set focusRect(value:Object):voidmouseEnabled | właściwość |
mouseEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy ten obiekt odbiera komunikaty z myszy lub innego urządzenia wejściowego użytkownika. Domyślna wartość to true, co oznacza, że domyślnie każda instancja klasy InteractiveObject znajdująca się na liście wyświetlania odbiera zdarzenia myszy lub innego urządzenia wejściowego. Jeśli dla właściwości mouseEnabled jest ustawiona wartość false, wystąpienie nie odbiera zdarzeń myszy (ani innych zdarzeń związanych z interakcją ze strony użytkownika, na przykład zdarzeń klawiatury). Nie ma to wypływu na żaden z obiektów podrzędnych instancji z listy wyświetlania. W celu zmiany zachowania mouseEnabled dla wszystkich obiektów podrzędnych z listy wyświetlania należy zastosować funkcję flash.display.DisplayObjectContainer.mouseChildren.
Ustawienie tej właściwości nie powoduje wywołania żadnego zdarzenia. Konieczne jest zastosowanie metody addEventListener() w celu utworzenia interaktywnej funkcjonalności.
Implementacja
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidPowiązane elementy interfejsu API
needsSoftKeyboard | właściwość |
needsSoftKeyboard:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.6 |
Określa, czy klawiatura wirtualna (klawiatura programowa wyświetlana na ekranie) powinna być wyświetlana, gdy to wystąpienie klasy InteractiveObject staje się aktywne.
Wartością domyślną jest false, a uaktywnienie wystąpienia klasy InteractiveObject nie powoduje uniesienia klawiatury programowej. Jeśli dla właściwości needsSoftKeyboard zostanie ustawiona wartość true, to gdy wystąpienie klasy InteractiveObject będzie gotowe na przyjęcie danych wejściowych użytkownika, środowisko wykonawcze uniesie klawiaturę programową. Wystąpienie klasy InteractiveObject jest gotowe na przyjęcie danych wejściowych użytkownika po wywołaniu programowym ustawiającym właściwość focus obiektu Stage lub po oddziaływaniu ze strony użytkownika, takim jak dotknięcie. Jeśli w systemie klienta jest dostępna klawiatura sprzętowa lub ten system nie obsługuje klawiatur wirtualnych, wówczas klawiatura programowa nie zostanie uniesiona.
Gdy klawiatura programowa jest unoszona i opuszczana, wystąpienie klasy InteractiveObject wywołuje zdarzenia softKeyboardActivating, softKeyboardActivate i softKeyboardDeactivate.
Uwaga: Ta właściwość nie jest obsługiwana w aplikacjach AIR w systemie iOS.
Implementacja
public function get needsSoftKeyboard():Boolean public function set needsSoftKeyboard(value:Boolean):voidPowiązane elementy interfejsu API
softKeyboard | właściwość |
softKeyboard:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 21.0 |
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 softKeyboard():String public function set softKeyboard(value:String):voidZgłasza
ArgumentError — Jeśli ustawiona jest dowolna wartość nienależąca do klasy SoftKeyboardType.
|
Powiązane elementy interfejsu API
softKeyboardInputAreaOfInterest | właściwość |
softKeyboardInputAreaOfInterest:Rectangle| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.6 |
Definiuje obszar, który powinien pozostać na ekranie po wyświetleniu klawiatury programowej (niedostępna w systemie iOS).
Jeśli właściwość needsSoftKeyboard tego obiektu InteractiveObject ma wartość true, wówczas podczas gdy użytkownik pisze, środowisko wykonawcze zgodnie z wymaganiami dostosowuje zawartość ekranu, aby obiekt był widoczny. Zwykle środowisko wykonawcze używa obwiedni obiektu uzyskanej z metody DisplayObject.getBounds(). Za pomocą właściwości softKeyboardInputAreaOfInterest można określić inny obszar.
Wartość właściwości softKeyboardInputAreaOfInterest należy określić za pomocą współrzędnych na stole montażowym.
Uwaga: W systemie Android w orientacjach poziomych właściwość softKeyboardInputAreaOfInterest nie jest przestrzegana.
Uwaga: Zmienna softKeyboardInputAreaOfInterest nie jest obsługiwana w systemie iOS.
Implementacja
public function get softKeyboardInputAreaOfInterest():Rectangle public function set softKeyboardInputAreaOfInterest(value:Rectangle):voidPowiązane elementy interfejsu API
tabEnabled | właściwość |
tabEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa, czy ten obiekt można osiągnąć za pomocą klawisza Tab. Wartość true, jeżeli obiekt ten można osiągnąć za pomocą klawisza Tab; w innym przypadku wartość false. Domyślnie wartość to false, z wyjątkiem sytuacji wymienionych poniżej:
- Wartość
truedla obiektu SimpleButton. - Wartość
truedla obiektu TextField z właściwościątype = "input". - Wartość
truedla obiektu Sprite lub obiektu MovieClip z właściwościąbuttonMode = true.
Implementacja
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | właściwość |
tabIndex:int| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Określa kolejność uaktywniania obiektów (z pliku SWF) za pomocą klawisza Tab. Właściwość tabIndex ma domyślnie wartość -1, co oznacza iż nie jest ustawiony indeks tabulacji dla tego obiektu.
Jeżeli dowolny z obecnie wyświetlanych obiektów w pliku SWF zawiera właściwość tabIndex, wówczas automatyczna kolejność uaktywniania dla klawisza Tab jest wyłączone, zaś kolejność jest określana przez właściwości tabIndex obiektów w pliku SWF. Do własnej kolejności uaktywniania dla klawisza Tab można włączyć tylko obiekty posiadające właściwości tabIndex.
Wartością właściwości tabIndex może być nie ujemna liczba całkowita. Obiekty są porządkowane zgodnie z właściwościami tabIndex w kolejności rosnącej. Obiekt z wartością właściwości tabIndex równą 1 ma pierwszeństwo względem obiektu z wartością właściwości tabIndex równą 2. Nie należy używać tej samej wartości tabIndex dla wielu obiektów.
Własna kolejność uaktywniania definiowana przez właściwość tabIndex to flat. Oznacza to, iż nie zwraca się uwagi na stosunki hierarchiczne obiektów w pliku SWF. Wszystkie obiekty w pliku SWF z właściwościami tabIndex są układane zgodnie z kolejnością aktywacji klawiszem Tab, która jest określane przez wartości właściwości tabIndex.
Uwaga: Aby ustawić kolejność aktywacji klawiszem Tab dla instancji TLFTextField, należy wykonać rzutowanie obiektu podrzędnego obiektu wyświetlanego TLFTextField na klasę InteractiveObject, a następnie ustawić właściwość tabIndex. Na przykład:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Aby odwrócić kolejność aktywacji klawiszem Tab względem ustawienia domyślnego dla trzech instancji obiektu TLFTextField (
tlfInstance1, tlfInstance2 i tlfInstance3), należy użyć poniższego kodu:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementacja
public function get tabIndex():int public function set tabIndex(value:int):voidInteractiveObject | () | Konstruktor |
public function InteractiveObject()| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywołanie do konstruktora new InteractiveObject() powoduje zgłoszenie wyjątku ArgumentError. Jednakże możliwe jest wywołanie konstruktorów następujących podklas obiektu InteractiveObject.
new SimpleButton()new TextField()new Loader()new Sprite()new MovieClip()
requestSoftKeyboard | () | metoda |
public function requestSoftKeyboard():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.6 |
Powoduje uniesienie klawiatury wirtualnej.
Wywołanie tej metody powoduje uaktywnienie wystąpienia klasy InteractiveObject i, w razie konieczności, uniesienie klawiatury programowej. Właściwość needsSoftKeyboard również musi mieć wartość true. Klawiatura nie zostaje uniesiona, jeśli jest dostępna klawiatura sprzętowa lub system klienta nie obsługuje klawiatur wirtualnych.
Uwaga: Ta metoda nie jest obsługiwana w aplikacjach AIR w systemie iOS.
ZwracaBoolean — Wartość true oznacza, że żądanie dotyczące klawiatury programowej zostało zaakceptowane. Wartość false oznacza, że klawiatura programowa nie została uniesiona.
|
Powiązane elementy interfejsu API
clear | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.CLEAR| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Wywoływane, gdy użytkownik wybierz opcje „Wyczyść” (lub „Usuń”) z menu kontekstowego dla tekstu. Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Jeśli obiektem aktualnie aktywnym jest pole TextField, domyślnie działanie tego zdarzenia powoduje usunięcie całego tekstu zaznaczonego w polu tekstowym.
StałaEvent.CLEAR definiuje wartość właściwości type obiektu zdarzenia clear.
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 | Dowolna instancja klasy InteractiveObject z detektorem zarejestrowanym dla zdarzenia clear. |
Uwaga: Obiekty TextField nie wywołują zdarzeń clear, copy, cut, paste ani selectAll. Dla obiektów TextField polecenia Wytnij, Kopiuj, Wklej, Usuń i Zaznacz wszystko są zawsze dostępne w menu kontekstowym. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll. Jednak inne klasy rozszerzające klasę InteractiveObject, łączenie z elementami zbudowanymi za pomocą mechanizmu Flash Text Engine (FTE), spowodują wywołanie tych zdarzeń w odpowiedzi na działania użytkownika takie jak używanie skrótów klawiaturowych i menu kontekstowych.
click | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.CLICK| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane w momencie naciśnięcia i zwolnienia głównego przycisku urządzenia wskazującego przez użytkownika na tej samej instancji InteractiveObject. Wystąpienie zdarzenia kliknięcia jest możliwe tylko po wystąpieniu zdarzeń w tej kolejności: zdarzenie mouseDown, a następnie MouseUp. Obiekt docelowy musi być identyczny w dla obu tych zdarzeń. W innym przypadku zdarzenie click nie występuje. Dowolna liczba innych zdarzeń myszy może wystąpić w dowolnym momencie pomiędzy zdarzeniami mouseDown i mouseUp; mimo tego zdarzenie click wciąż występuje.
type obiektu zdarzenia click.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | W przypadku zdarzeń kliknięcia ta wartość zawsze jest równa false. |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
contextMenu | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.CONTEXT_MENU| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane, gdy w wyniku gestu użytkownika zostanie uaktywnione menu kontekstowe skojarzone z tym obiektem interaktywnym w aplikacji AIR.
StałaMouseEvent.CONTEXT_MENU definiuje wartość właściwości type obiektu zdarzenia contextMenu.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli prawy przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
clickCount | Liczba kliknięć myszą określająca, czy zdarzenie jest częścią sekwencji wielu kliknięć. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
Powiązane elementy interfejsu API
copy | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.COPY| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
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. Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Jeśli obiektem aktualnie aktywnym jest pole TextField, domyślnie działanie tego zdarzenia powoduje skopiowanie do schowka całego tekstu zaznaczonego w polu tekstowym.
Definiuje wartość właściwościtype obiektu zdarzenia copy.
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 | Dowolna instancja klasy InteractiveObject z detektorem zarejestrowanym dla zdarzenia copy. |
Uwaga: Obiekty TextField nie wywołują zdarzeń clear, copy, cut, paste ani selectAll. Dla obiektów TextField polecenia Wytnij, Kopiuj, Wklej, Usuń i Zaznacz wszystko są zawsze dostępne w menu kontekstowym. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll. Jednak inne klasy rozszerzające klasę InteractiveObject, łączenie z elementami zbudowanymi za pomocą mechanizmu Flash Text Engine (FTE), spowodują wywołanie tych zdarzeń w odpowiedzi na działania użytkownika takie jak używanie skrótów klawiaturowych i menu kontekstowych.
cut | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.CUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
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. Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Jeśli obiektem aktualnie aktywnym jest pole TextField, domyślnie działanie tego zdarzenia powoduje wycięcie do schowka całego tekstu zaznaczonego w polu tekstowym.
Definiuje wartość właściwościtype obiektu zdarzenia cut.
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 | Dowolna instancja klasy InteractiveObject z detektorem zarejestrowanym dla zdarzenia cut. |
Uwaga: Obiekty TextField nie wywołują zdarzeń clear, copy, cut, paste ani selectAll. Dla obiektów TextField polecenia Wytnij, Kopiuj, Wklej, Usuń i Zaznacz wszystko są zawsze dostępne w menu kontekstowym. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll. Jednak inne klasy rozszerzające klasę InteractiveObject, łączenie z elementami zbudowanymi za pomocą mechanizmu Flash Text Engine (FTE), spowodują wywołanie tych zdarzeń w odpowiedzi na działania użytkownika takie jak używanie skrótów klawiaturowych i menu kontekstowych.
doubleClick | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.DOUBLE_CLICK| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
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. Wystąpienie zdarzenia doubleClick jest możliwe tylko po wystąpieniu zdarzeń w tej kolejności: mouseDown, mouseUp, click, mouseDown, mouseUp. Wszystkie te zdarzenia muszą mieć ten sam cel co zdarzenie doubleClick. Drugie kliknięcie, reprezentowane przez drugie zdarzenia mouseDown i mouseUp, musi wystąpić w określonym okresie czasu po zdarzeniu click. Dozwolona długość tego okresu czasu jest zmienna w zależności od systemu operacyjnego, a często może być również konfigurowana przez użytkownika. Jeżeli celem jest pole tekstowe możliwe do wybrania, wówczas słowo znajdujące się pod wskaźnikiem jest wybierane jako zachowanie domyślne. Jeżeli docelowy obiekt InteractiveObject nie posiada flagi doubleClickEnabled ustawionej na wartość true, wówczas otrzymuje dwa zdarzenia click.
Domyślnie właściwość doubleClickEnabled ma wartość false.
Zachowanie wyboru tekstu przez dwukrotne kliknięcie myszą obiektu TextField nie jest związane ze zdarzeniem doubleClick. Należy wykorzystać właściwość TextField.doubleClickEnabled w celu kontrolowania sposobu wybierania w obiektach TextField.
type obiektu zdarzenia doubleClick. Aby obiekt generował zdarzenie doubleClick, właściwość doubleClickEnabled musi być ustawiona na true.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | W przypadku zdarzeń dwukrotnego kliknięcia ta wartość zawsze jest równa false. |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
Powiązane elementy interfejsu API
focusIn | Zdarzenie |
flash.events.FocusEventwłaściwość FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane po uzyskaniu aktywności przez obiekt wyświetlany. Dzieje się to w momencie podświetlenia obiektu przez użytkownika przy użyciu urządzenia wskazującego lub nawigacji klawiaturą. Obiekt, który stał się aktywny, jest nazywany obiektem docelowym tego zdarzenia, podczas gdy odpowiednia instancja InteractiveObject, która utraciła aktywność, jest nazwana obiektem powiązanym. Odwołanie do obiektu związanego jest przechowywane we właściwości relatedObject obiektu uzyskującego. Właściwość shiftKey nie jest stosowana. Zdarzenie to następuje po wywołaniu poprzedniego zdarzenia focusOut.
type 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.FocusEventwłaściwość FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane po utracie aktywności przez obiekt wyświetlany. Dzieje się to w momencie podświetlenia innego obiektu przez użytkownika przy użyciu urządzenia wskazującego lub nawigacji klawiaturą. Obiekt, który utracił aktywność, jest nazwany obiektem docelowym tego zdarzenia, podczas gdy odpowiednia instancja InteractiveObject, która stała się aktywna, jest nazwana obiektem powiązanym. Odwołanie do obiektu związanego jest przechowywane we właściwości relatedObject obiektu docelowego. Właściwość shiftKey nie jest stosowana. Zdarzenie to uprzedza wywołanie zdarzenia focusIn przez obiekt związany.
type 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.
|
gestureDirectionalTap | Zdarzenie |
flash.events.TransformGestureEventwłaściwość TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_DIRECTIONAL_TAP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 24, Flash Lite 4 |
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.
W szczególności, jeśli użytkownik dotknie jednym palcem obiekt InteractiveObject, a następnie dodatkowo odsunie palce, instancja InteractiveObject może rozesłać zdarzenie touchBegin i zdarzenie touchEnd (między innymi), a nie tylko zdarzenie gestureDirectionalTap, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie touchBegin, wówczas ten sam podprogram obsługi zdarzenia będzie działał na urządzeniu dotykowym. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureDirectionalTap, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia gestu, a inaczej na zdarzenia dotyku. Jednak to klasa flash.ui.Multitouch decyduje, czy uruchomione zostaje zdarzenie dotyku czy zdarzenie gestu.
Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu (w przypadku telewizora firmy Apple jest to środek ekranu). Właściwości offsetX i offsetY odpowiadają kierunkowi gestu.
Uwaga: ten interfejs API obsługuje wyłącznie dotknięcia kierunkowe jednym palcem.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku GESTURE_DIRECTIONAL_TAP.
Wywołany obiekt TransformGestureEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
phase | Bieżąca faza przepływu zdarzeń. W przypadku gestów machnięcia ta wartość zawsze jest równa all i odpowiada wartości GesturePhase.ALL, czyli fazie rozpoczynającej się z chwilą wywołania zdarzenia. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). W przypadku gestów stuknięć kierunkowych jest to wartość środka ekranu. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). W przypadku gestów stuknięć kierunkowych jest to wartość środka ekranu. |
scaleX | Skala pozioma obiektu ekranowego. W przypadku gestów stuknięć kierunkowych ta wartość wynosi 1 |
scaleY | Skala pionowa obiektu ekranowego. W przypadku gestów stuknięć kierunkowych ta wartość wynosi 1 |
rotation | Bieżący stopień obrotu obiektu ekranowego wzdłuż osi Z. W przypadku gestów stuknięć kierunkowych ta wartość wynosi 0 |
offsetX | Określa zwrot w kierunku poziomym: 1 w prawo, -1 w lewo. |
offsetY | Określa zwrot w kierunku pionowym: 1 w dół, -1 w górę. |
velocity | Wskazuje szybkość gestu przeciągnięcia wyrażoną w pikselach na sekundę (tylko środowisko AIR). |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
Powiązane elementy interfejsu API
gestureLongPress | Zdarzenie |
flash.events.TapGestureEventwłaściwość TapGestureEvent.type =
flash.events.GestureEvent.GESTURE_LONG_PRESS| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie doubleClick.
W szczególności, jeśli użytkownik stuknie dwoma palcami w instancję klasy InteractiveObject, instancja ta może wywołać zdarzenie doubleClick i/lub zdarzenie gestureTwoFingerTap, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie doubleClick, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureTwoFingerTap, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Powiązane elementy interfejsu API
gesturePan | Zdarzenie |
flash.events.TransformGestureEventwłaściwość TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_PAN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Niektóre urządzenia mogą zinterpretować ten kontakt jako zdarzenie mouseOver i jako zdarzenie touchOver.
W szczególności, jeśli użytkownik przesunie palec nad obiekt InteractiveObject, instancja InteractiveObject może wywołać zdarzenie mouseOver, touchOver, gesturePan lub wszystkie te zdarzenia, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gesturePan, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype obiektu zdarzenia dotyku GESTURE_PAN.
Wywołany obiekt TransformGestureEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
phase | Bieżąca faza w przepływie zdarzeń; wartość z klasy GesturePhase. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu ekranowego). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu ekranowego). |
scaleX | Skala pozioma obiektu ekranowego od poprzedniego zdarzenia gestu. W przypadku gestów panoramowania ta wartość wynosi 1. |
scaleY | Skala pionowa obiektu ekranowego od poprzedniego zdarzenia gestu. W przypadku gestów panoramowania ta wartość wynosi 1. |
rotation | Bieżący stopień obrotu (w stopniach) obiektu ekranowego wzdłuż osi Z, od poprzedniego zdarzenia gestu. W przypadku gestów panoramowania ta wartość wynosi 0. |
offsetX | Translacja w poziomie obiektu ekranowego z położenia w poprzednim zdarzeniu gestu. |
offsetY | Translacja w pionie obiektu ekranowego z położenia w poprzednim zdarzeniu gestu. |
velocity | Szybkość zdarzenia gestu wyrażona w pikselach na sekundę (tylko środowisko AIR). W przypadku gestu panoramowania ta wartość wynosi 0 |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
Przykład ( Sposób korzystania z tego przykładu )
GESTURE_PAN. Gdy użytkownik wykonuje gest panoramowania na urządzeniu dotykowym, pole myTextField jest zapełniane informacją o aktualnej fazie obsługi.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onPan(evt:TransformGestureEvent):void {
evt.target.localX++;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Powiązane elementy interfejsu API
gestureRotate | Zdarzenie |
flash.events.TransformGestureEventwłaściwość TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ROTATE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Obrót dwóch palców jest typowym gestem obracania, jednak każde urządzenie i każdy system operacyjny może mieć własne wymagania co do sposobu aktywacji obrotu. Niektóre urządzenia mogą zinterpretować taki gest jako kombinację kilku zdarzeń myszy.
W szczególności, jeśli użytkownik przesunie palec nad obiekt InteractiveObject, instancja InteractiveObject może wywołać zdarzenie mouseOver i zdarzenie click (między innymi), a nie tylko zdarzenie gestureRotate, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureRotate, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu. Właściwości offsetX i offsetY to odległość od punktu kontaktu, w której zakończył się gest obrotu.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku GESTURE_ROTATE.
W czasie tego zdarzenia właściwość rotation zawiera wartość kąta obrotu. Wartości obrotu są następujące:
- Od 0 do 180 stopni dla obrotów w prawo.
- Od –180 do 0 stopni dla obrotów w lewo.
Wywołany obiekt TransformGestureEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
phase | Bieżąca faza w przepływie zdarzeń; wartość z klasy GesturePhase. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu ekranowego). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu ekranowego). |
scaleX | Skala pozioma obiektu ekranowego od poprzedniego zdarzenia gestu. |
scaleY | Skala pionowa obiektu ekranowego od poprzedniego zdarzenia gestu. |
rotation | Bieżący stopień obrotu (w stopniach) obiektu ekranowego wzdłuż osi Z, od poprzedniego zdarzenia gestu. |
offsetX | Translacja w poziomie obiektu ekranowego z położenia w poprzednim zdarzeniu gestu. |
offsetY | Translacja w pionie obiektu ekranowego z położenia w poprzednim zdarzeniu gestu. |
velocity | Szybkość zdarzenia gestu wyrażona w pikselach na sekundę (tylko środowisko AIR). W przypadku gestu obrotu ta wartość wynosi 0 |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
Przykład ( Sposób korzystania z tego przykładu )
GESTURE_ROTATE. Gdy użytkownik wykonuje gest obrotu na urządzeniu dotykowym, obiekt mySprite obraca się, a pole myTextField jest zapełniane informacją o aktualnej fazie obsługi.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onRotate(evt:TransformGestureEvent):void {
evt.target.rotation -= 45;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Powiązane elementy interfejsu API
gestureSwipe | Zdarzenie |
flash.events.TransformGestureEventwłaściwość TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_SWIPE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Przesunięcie kilku złączonych palców jest typowym gestem machnięcia, jednak każde urządzenie i system operacyjny może wymagać innego sposobu realizacji tego gestu. Niektóre urządzenia mogą zinterpretować taki gest jako kombinację kilku zdarzeń myszy.
W szczególności, jeśli użytkownik przesunie jeden palec nad obiektem InteractiveObject, a następnie złączy palce, instancja InteractiveObject może wywołać zdarzenie rollOver i zdarzenie rollOut (między innymi), a nie tylko zdarzenie gestureSwipe, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Jeśli kod użytkownika będzie obsługiwał zdarzenie rollOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureSwipe, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu. Właściwości offsetX i offsetY to odległość od punktu kontaktu, w której zakończył się gest machnięcia.
Uwaga: Wprawdzie niektóre urządzenia z systemem operacyjnym Mac OS mogą prawidłowo interpretować machnięcie czterema palcami, ten interfejs API obsługuje tylko machnięcie trzema palcami.
Definiuje wartość właściwościtype obiektu zdarzenia dotyku GESTURE_SWIPE.
Wywołany obiekt TransformGestureEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
phase | Bieżąca faza przepływu zdarzeń. W przypadku gestów machnięcia ta wartość zawsze jest równa all i odpowiada wartości GesturePhase.ALL, czyli fazie rozpoczynającej się z chwilą wywołania zdarzenia. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
scaleX | Skala pozioma obiektu ekranowego. W przypadku gestów machnięcia ta wartość wynosi 1. |
scaleY | Skala pionowa obiektu ekranowego. W przypadku gestów machnięcia ta wartość wynosi 1. |
rotation | Bieżący stopień obrotu obiektu ekranowego wzdłuż osi Z. W przypadku gestów machnięcia ta wartość wynosi 0. |
offsetX | Określa zwrot w kierunku poziomym: 1 w prawo, -1 w lewo. |
offsetY | Określa zwrot w kierunku pionowym: 1 w dół, -1 w górę. |
velocity | Wskazuje szybkość gestu przeciągnięcia wyrażoną w pikselach na sekundę (tylko środowisko AIR). W pozostałych przypadkach ta wartość wynosi 0 |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
Przykład ( Sposób korzystania z tego przykładu )
GESTURE_SWIPE. Gdy użytkownik wykonuje gest machnięcia na urządzeniu dotykowym, w polu tekstowym myTextField wpisywana jest faza all, czyli jedyna faza obsługi gestów machnięcia.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onSwipe(evt:TransformGestureEvent):void {
if (evt.offsetX == 1 ) {
myTextField.text = "right";
}
if (evt.offsetY == -1) {
myTextField.text = "up";
}
myTextField.text = evt.phase;
}
Powiązane elementy interfejsu API
gestureTap | Zdarzenie |
flash.events.TapGestureEventwłaściwość TapGestureEvent.type =
flash.events.PressAndTapGestureEvent.GESTURE_TAP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Niektóre urządzenia mogą zinterpretować taki gest jako kombinację kilku zdarzeń myszy.
W szczególności, jeśli użytkownik przesunie jeden palec nad obiekt InteractiveObject, a następnie dodatkowo stuknie, instancja InteractiveObject może wywołać zdarzenie mouseOver i zdarzenie click (między innymi), a nie tylko zdarzenie gesturePressAndTap, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gesturePressAndTap, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu („przyłożenia”). Właściwości offsetX i offsetY to odległości do dodatkowego punktu kontaktu („stuknięcia”).
Powiązane elementy interfejsu API
gestureZoom | Zdarzenie |
flash.events.TransformGestureEventwłaściwość TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ZOOM| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Rozsunięcie palców jest typowym gestem powiększenia, jednak każde urządzenie i każdy system operacyjny może mieć własne wymagania co do sposobu aktywacji powiększenia. Niektóre urządzenia mogą zinterpretować taki gest jako kombinację kilku zdarzeń myszy.
W szczególności, jeśli użytkownik przesunie jeden palec nad obiekt InteractiveObject, a następnie rozsunie palce, instancja InteractiveObject może wywołać zdarzenie mouseOver i zdarzenie click (między innymi), a nie tylko zdarzenie gestureZoom, o ile bieżące środowisko obsługuje taki gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie gestureZoom, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Korzystając z właściwości obiektu zdarzenia, należy zwrócić uwagę, że właściwości localX i localY określają podstawowy punkt kontaktu. Właściwości offsetX i offsetY to odległość od punktu kontaktu, w której zakończył się gest powiększania.
Uwaga: Informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku GESTURE_ZOOM.
Wywołany obiekt TransformGestureEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
phase | Bieżąca faza w przepływie zdarzeń; wartość z klasy GesturePhase. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu ekranowego). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu ekranowego). |
scaleX | Skala pozioma obiektu ekranowego od poprzedniego zdarzenia gestu. |
scaleY | Skala pionowa obiektu ekranowego od poprzedniego zdarzenia gestu. |
rotation | Bieżący stopień obrotu (w stopniach) obiektu ekranowego wzdłuż osi Z, od poprzedniego zdarzenia gestu. |
offsetX | Translacja w poziomie obiektu ekranowego z położenia w poprzednim zdarzeniu gestu. |
offsetY | Translacja w pionie obiektu ekranowego z położenia w poprzednim zdarzeniu gestu. |
velocity | Szybkość zdarzenia gestu wyrażona w pikselach na sekundę (tylko środowisko AIR). W przypadku gestu powiększania ta wartość wynosi 0 |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
Przykład ( Sposób korzystania z tego przykładu )
GESTURE_ZOOM. Gdy użytkownik wykonuje gest zmiany powiększenia na urządzeniu dotykowym, pole myTextField jest zapełniane informacją o aktualnej fazie obsługi.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onZoom(evt:TransformGestureEvent):void {
evt.target.scaleX++;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Powiązane elementy interfejsu API
imeStartComposition | Zdarzenie |
flash.events.IMEEvent| Wersje środowiska wykonawczego: | Flash Lite 4 |
To zdarzenie jest wywoływane w każdej aplikacji klienckiej, która obsługuje lokalne wprowadzanie znaków za pomocą edytora IME.
keyDown | Zdarzenie |
flash.events.KeyboardEventwłaściwość KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik naciśnie 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ą wykorzystywane w celu wprowadzania znaków, jak na przykład chińskich ideogramów, których wygenerowanie przy pomocy standardowej klawiatury QWERTY jest utrudnione. Zdarzenie to występuje przed zdarzeniem keyUp.
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. |
keyFocusChange | Zdarzenie |
flash.events.FocusEventwłaściwość FocusEvent.type =
flash.events.FocusEvent.KEY_FOCUS_CHANGE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik próbuje uaktywnić inny element za pomocą klawiatury. Domyślnym zachowaniem tego zdarzenia jest zmiana aktywnego elementu i wywołanie odpowiednich zdarzeń focusIn i focusOut.
Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Obiektem związanym z tym zdarzeniem jest instancja InteractiveObject, która staje się aktywna, jeżeli użytkownik nie zapobiegnie zachowaniu domyślnemu. Można zapobiec przenoszeniu aktywności poprzez wywołanie metody preventDefault() w detektorze zdarzeń, który jest poprawnie zarejestrowany dla obiektu docelowego. Stan aktywacji ulega zmianie i domyślnie wywoływane są zdarzenia focusIn i focusOut.
type obiektu zdarzenia keyFocusChange.
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ń. |
keyCode | Kod klawisza, którego naciśnięcie wywołało zdarzenie keyFocusChange. |
relatedObject | Komplementarna instancja klasy InteractiveObject, która zmienia się wskutek przeniesienia aktywności. |
shiftKey | true, jeśli aktywny jest klawisz modyfikujący Shift; false w przeciwnym razie. |
target | Instancja klasy InteractiveObject, która jest obecnie 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.KeyboardEventwłaściwość KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik zwolni 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ą wykorzystywane w celu wprowadzania znaków, jak na przykład chińskich ideogramów, których wygenerowanie przy pomocy standardowej klawiatury QWERTY jest utrudnione. Zdarzenie to występuje po zdarzeniu keyDown i posiada niżej wymienione cechy:
ScreenMouseEvent.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. |
middleClick | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MIDDLE_CLICK| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane, gdy użytkownik naciśnie i zwolni środkowy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. Aby zaszło zdarzenie middleClick, wcześniej muszą wystąpić kolejno zdarzenia middleMouseDown i middleMouseUp. Obiekt docelowy musi być identyczny w dla obu tych zdarzeń. W innym przypadku zdarzenie middleClick nie występuje. Dowolna liczba innych zdarzeń myszy może wystąpić w dowolnym momencie pomiędzy zdarzeniami middleMouseDown i middleMouseUp; mimo tego zdarzenie middleClick wciąż występuje.
type obiektu zdarzenia middleClick.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | W przypadku zdarzeń kliknięcia środkowym przyciskiem ta właściwość zawsze jest równa false. |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
middleMouseDown | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_DOWN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane, gdy użytkownik naciśnie środkowy przycisk urządzenia wskazującego nad instancją klasy InteractiveObject.
Definiuje wartość właściwościtype obiektu zdarzenia middleMouseDown.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli środkowy przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
clickCount | Liczba kliknięć myszą określająca, czy zdarzenie jest częścią sekwencji wielu kliknięć. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
middleMouseUp | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_UP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject.
Definiuje wartość właściwościtype obiektu zdarzenia middleMouseUp.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli środkowy przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
clickCount | Liczba kliknięć myszą określająca, czy zdarzenie jest częścią sekwencji wielu kliknięć. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
mouseDown | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MOUSE_DOWN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. Jeżeli celem jest instancja SimpleButton, wówczas instancja ta wyświetla obiekt wyświetlany downState jako zachowanie domyślne. Jeżeli celem jest pole tekstowe możliwe do wybrania, wówczas pole tekstowe rozpoczyna wybór jako zachowanie domyślne.
type obiektu zdarzenia a mouseDown.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
clickCount | Liczba kliknięć myszą określająca, czy zdarzenie jest częścią sekwencji wielu kliknięć. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
mouseFocusChange | Zdarzenie |
flash.events.FocusEventwłaściwość FocusEvent.type =
flash.events.FocusEvent.MOUSE_FOCUS_CHANGE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik próbuje uaktywnić inny element za pomocą urządzenia wskazującego. Domyślnym zachowaniem tego zdarzenia jest zmiana aktywnego elementu i wywołanie odpowiednich zdarzeń focusIn i focusOut.
Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Obiektem związanym z tym zdarzeniem jest instancja InteractiveObject, która staje się aktywna, jeżeli użytkownik nie zapobiegnie zachowaniu domyślnemu. Można zapobiec zmianie aktywności poprzez wywołanie metody preventDefault() w detektorze zdarzeń, który jest poprawnie zarejestrowany dla obiektu docelowego. Właściwość shiftKey nie jest stosowana. Stan aktywacji ulega zmianie i domyślnie wywoływane są zdarzenia focusIn i focusOut.
type obiektu zdarzenia mouseFocusChange.
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ń. |
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 jest obecnie 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.
|
mouseMove | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MOUSE_MOVE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik ustawi kursor nad instancją obiektu InteractiveObject i poruszy urządzenie wskazujące. Jeżeli celem jest pole tekstowe wybierane przez użytkownika, wówczas wybór jest aktualizowany jako zachowanie domyślne.
Definiuje wartość właściwościtype obiektu zdarzenia mouseMove.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
mouseOut | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MOUSE_OUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik przesunie kursor poza instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). Celem zdarzenia jest obiekt znajdujący się uprzednio pod urządzeniem wskazującym lub obiekt macierzysty tego obiektu. Obiekt relatedObject jest obiektem, na który zostało przesunięte urządzenie wskazujące. Jeżeli celem jest instancja SimpleButton, wówczas przycisk wyświetla obiekt wyświetlany upState jako zachowanie domyślne.
Zdarzenie mouseOut jest wywoływane za każdym razem, gdy mysz opuszcza obszar dowolnego obiektu podrzędnego kontenera obiektów wyświetlanych, nawet gdy mysz pozostaje nad innym obiektem podrzędnym kontenera. Jest to zachowanie inne niż w przypadku zdarzenia rollOut, którego celem jest uproszczenie kodowania zachowań typu rollover dla kontenerów obiektów wyświetlanych z obiektami podrzędnymi. W momencie opuszczenia przez mysz obszaru obiektu wyświetlanego lub obszar któregoś z jego obiektów podrzędnych w celu przejścia do obiektu innego niż podrzędny, wówczas obiekt wyświetlany wywołuje zdarzenie rollOut. Zdarzenia rollOut są wywoływane kolejno w górę nadrzędnego łańcucha obiektu, zaczynając od wybranego obiektu, a kończąc na najwyższym obiektem nadrzędnym, który nie jest elementem głównym lub obiektem przodka obiektu relatedObject.
type obiektu zdarzenia mouseOut.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
relatedObject | Obiekt listy wyświetlania wskazywany teraz przez urządzenie wskazujące. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
mouseOver | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MOUSE_OVER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dysponowana, gdy użytkownik przesunie kursor nad instancję obiektu InteractiveObject (za pomocą urządzenia wskazującego). Obiekt relatedObject jest obiektem, który poprzednio znajdował się pod urządzeniem wskazującym. Jeżeli celem jest instancja SimpleButton, obiekt wyświetla obiekt wyświetlany overState lub upState, w zależności od tego czy przycisk myszy jest naciśnięty, jako zachowanie domyślne.
Zdarzenie mouseOver jest wywoływane za każdym razem, gdy mysz znajduje się na obszarze dowolnego obiektu podrzędnego kontenera obiektów wyświetlanych, nawet gdy mysz znajdowała się już nad innym obiektem podrzędnym kontenera. Jest to zachowanie inne niż w przypadku zdarzenia rollOver, którego celem jest uproszczenie kodowania zachowań typu rollout dla kontenerów obiektów wyświetlanych z obiektami podrzędnymi. W chwili wprowadzenia myszy na obszar obiektu ekranowego lub obszar któregoś z jego obiektów potomnych z obiektu innego niż potomny obiekt ekranowy wywołuje zdarzenie rollOver. Zdarzenia rollover są wywoływane kolejno w dół łańcucha obiektów macierzystych, zaczynając od obiektu macierzystego najwyższego poziomu, który nie jest obiektem głównym ani przodkiem obiektu relatedObject, a na wybranym obiekcie kończąc.
type obiektu zdarzenia mouseOver.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
relatedObject | Obiekt listy wyświetlania, na który wskazywało urządzenie wskazujące. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
mouseUp | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MOUSE_UP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad instancją klasy InteractiveObject. Jeżeli celem jest instancja SimpleButton, wówczas obiekt wyświetla obiekt wyświetlany upState. Jeżeli celem jest pole tekstowe możliwe do wybrania, wówczas pole tekstowe zakańcza wybór jako zachowanie domyślne.
type obiektu zdarzenia mouseUp.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
clickCount | Liczba kliknięć myszą określająca, czy zdarzenie jest częścią sekwencji wielu kliknięć. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
mouseWheel | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.MOUSE_WHEEL| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Wywoływane, gdy kółko myszy zostanie obrócone nad instancją klasy InteractiveObject. Jeżeli celem jest pole tekstowe, wówczas tekst jest przewijany zgodnie z domyślnym zachowaniem. Dostępna tylko w systemach operacyjnych Microsoft Windows.
Definiuje wartość właściwościtype obiektu zdarzenia mouseWheel.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
delta | Liczba wierszy odpowiadająca najmniejszej jednostce obrotu pokrętła myszy. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
nativeDragComplete | Zdarzenie |
flash.events.NativeDragEventwłaściwość NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane przez obiekt InteractiveObject inicjujący przeciąganie, gdy użytkownik zwolni przycisk podczas przeciągania.
Właściwość dropAction określa czynność zdefiniowaną przez obiekt docelowy przeciągania; wartość "none" (DragActions.NONE) oznacza, że upuszczenie zostało anulowane lub nie zostało zaakceptowane.
Moduł obsługi zdarzeń nativeDragComplete jest dogodnym miejscem do aktualizacji stanu inicjującego obiektu ekranowego, na przykład przez usunięcie pozycji z listy (w odpowiedzi na operację przeciągania „move”) lub zmianę właściwości wizualnych.
type obiektu zdarzenia nativeDragComplete.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
nativeDragDrop | Zdarzenie |
flash.events.NativeDragEventwłaściwość NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_DROP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane przez docelowy obiekt InteractiveObject, gdy przeciągany obiekt zostanie na niego upuszczony i upuszczenie zostanie zaakceptowane wywołaniem DragManager.acceptDragDrop().
Dostęp do upuszczonych danych jest możliwy za pośrednictwem właściwości clipboard obiektu zdarzenia.
Procedura obsługi tego zdarzenia powinna ustawiać właściwość DragManager.dropAction, aby poinformować obiekt inicjujący o rodzaju podjętej czynności przeciągania. Jeśli nie zostanie ustawiona żadna wartość, obiekt DragManager wybierze wartość domyślną z listy dozwolonych czynności.
type obiektu zdarzenia nativeDragDrop.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | true; anulowanie tego zdarzenia powoduje anulowanie operacji przeciągania. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. Zawartość schowka można odczytywać nawet wtedy, gdy obiekt wywołujący to zdarzenie jest w innej domenie zabezpieczeń, co obiekt inicjujący. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
nativeDragEnter | Zdarzenie |
flash.events.NativeDragEventwłaściwość NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_ENTER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik wchodzi w granice tego obiektu.
Aby umożliwić obiektowi pełnienie roli celu upuszczania, należy obsługiwać zdarzenia nativeDragEnter albo nativeDragOver.
Aby określić, czy wywołujący obiekt wyświetlany może zaakceptować upuszczenie, należy sprawdzić, czy dane we właściwości clipboard obiektu zdarzenia są dla niego odpowiednie, a także sprawdzić we właściwości allowedActions, jakie czynności przeciągania są dozwolone.
type obiektu zdarzenia nativeDragEnter.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. Zawartość schowka można odczytywać tylko wtedy, gdy obiekt wywołujący to zdarzenie jest w tej samej domenie zabezpieczeń, co obiekt inicjujący. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
nativeDragExit | Zdarzenie |
flash.events.NativeDragEventwłaściwość NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_EXIT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane przez obiekt InteractiveObject, gdy podczas gestu przeciągania wskaźnik opuści granice tego obiektu.
Stała NativeDragEvent.NATIVE_DRAG_EXIT definiuje wartość właściwościtype obiektu zdarzenia nativeDragExit.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. Zawartość schowka można odczytywać tylko wtedy, gdy obiekt wywołujący to zdarzenie jest w tej samej domenie zabezpieczeń, co obiekt inicjujący. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
nativeDragOver | Zdarzenie |
flash.events.NativeDragEventwłaściwość NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_OVER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Regularnie ywoływane przez obiekt InteractiveObject, gdy wskaźnik podczas przeciągania pozostaje w granicach tego obiektu.
Zdarzenia nativeDragOver są wywoływane po każdym poruszeniu myszy. W systemach Windows i Mac są także wywoływane regularnie w krótkich odstępach czasu, nawet gdy mysz nie porusza się.
Aby umożliwić obiektowi pełnienie roli celu upuszczania, należy obsługiwać zdarzenia nativeDragOver albo nativeDragEnter.
Aby określić, czy wywołujący obiekt ekranowy może zaakceptować upuszczenie, należy sprawdzić, czy dane we właściwości clipboard obiektu zdarzenia są dla niego odpowiednie, a także sprawdzić we właściwości allowedActions, jakie czynności przeciągania są dozwolone.
type obiektu zdarzenia nativeDragOver.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | true; anulowanie tego zdarzenia powoduje anulowanie operacji przeciągania. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. Zawartość schowka można odczytywać tylko wtedy, gdy obiekt wywołujący to zdarzenie jest w tej samej domenie zabezpieczeń, co obiekt inicjujący. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
nativeDragStart | Zdarzenie |
flash.events.NativeDragEventwłaściwość NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_START| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane na początku operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag().
Stała NativeDragEvent.NATIVE_DRAG_START definiuje wartość właściwościtype obiektu zdarzenia nativeDragStart.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | true; anulowanie tego zdarzenia powoduje anulowanie operacji przeciągania. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
nativeDragUpdate | Zdarzenie |
flash.events.NativeDragEventwłaściwość NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane podczas operacji przeciągania przez obiekt InteractiveObject określony jako inicjator przeciągania w wywołaniu DragManager.doDrag().
Zdarzenia nativeDragUpdate nie są wywoływane w systemie Linux.
type obiektu zdarzenia nativeDragUpdate.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
allowedActions | Obiekt NativeDragOptions określający operacje istotne w tej operacji przeciągania. |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
clipboard | Obiekt Clipboard zawierający dane przeciąganego elementu. |
dropAction | Operacja wybrana przez cel upuszczania (lub none, jeśli nie określono operacji). |
paste | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.PASTE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
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. Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Jeśli obiektem aktualnie aktywnym jest pole TextField, domyślnie działanie tego zdarzenia powoduje wklejenie zawartości schowka do pola tekstowego w bieżącym punkcie wstawiania, co powoduje zastąpienie aktualnie zaznaczonego tekstu w polu tekstowym.
StałaEvent.PASTE definiuje wartość właściwości type obiektu zdarzenia paste.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | true (false w środowisku wykonawczym AIR) |
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 | Dowolna instancja klasy InteractiveObject z detektorem zarejestrowanym dla zdarzenia paste. |
Uwaga: Obiekty TextField nie wywołują zdarzeń clear, copy, cut, paste ani selectAll. Dla obiektów TextField polecenia Wytnij, Kopiuj, Wklej, Usuń i Zaznacz wszystko są zawsze dostępne w menu kontekstowym. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll. Jednak inne klasy rozszerzające klasę InteractiveObject, łączenie z elementami zbudowanymi za pomocą mechanizmu Flash Text Engine (FTE), spowodują wywołanie tych zdarzeń w odpowiedzi na działania użytkownika takie jak używanie skrótów klawiaturowych i menu kontekstowych.
proximityBegin | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_BEGIN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane, gdy użytkownik opuści aktywny pisak na odległość mniejszą niż graniczna odległość wykrywania dla ekranu.
Typowa sekwencja zdarzeń wywołana opuszczeniem pisaka na ekran, przesuwaniem pisaka po ekranie, a następnie podniesieniem pisaka do góry jest następująca:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku PROXIMITY_BEGIN.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
proximityEnd | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_END| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
Wywoływane, gdy użytkownik uniesie aktywny pisak na odległość większą niż graniczna odległość wykrywania dla ekranu.
Zdarzenie proximityEnd nie jest wywoływane, gdy pisak dotyka ekranu.
Typowa sekwencja zdarzeń wywołana opuszczeniem pisaka na ekran, przesuwaniem pisaka po ekranie, a następnie podniesieniem pisaka do góry jest następująca:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku PROXIMITY_END.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
proximityMove | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_MOVE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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.
Typowa sekwencja zdarzeń wywołana opuszczeniem pisaka na ekran, przesuwaniem pisaka po ekranie, a następnie podniesieniem pisaka do góry jest następująca:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku PROXIMITY_MOVE.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
proximityOut | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku PROXIMITY_OUT.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
proximityOver | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OVER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku PROXIMITY_OVER.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
proximityRollOut | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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.
Elementem docelowym zdarzenia jest obiekt znajdujący się wcześniej pod pisakiem lub obiekt macierzysty tego obiektu. Obiekt relatedObject jest obiektem, nad który został przesunięty pisak. Zdarzenia proximityRollOut są wywoływane kolejno w górę łańcucha obiektów macierzystych, zaczynając od wybranego obiektu, a kończąc na najwyższym obiekcie macierzystym, który nie jest obiektem głównym ani przodkiem obiektu relatedObject.
Celem zdarzenia proximityRollOut jest uproszczenie kodowania zachowań typu rollover dla kontenerów obiektów ekranowych z obiektami potomnymi. Opuszczenie przez pisak obszaru obiektu ekranowego, w tym obszaru jego obiektów potomnych, w celu przejścia do obiektu niebędącego obiektem potomnym tego obiektu wywołuje zdarzenie proximityRollOut. Jest to zachowanie inne niż w przypadku zdarzenia proximityOut, które jest wywoływane za każdym razem, gdy mysz opuszcza obszar dowolnego obiektu potomnego kontenera obiektów ekranowych, nawet gdy mysz pozostaje nad innym obiektem potomnym tego kontenera.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku PROXIMITY_ROLL_OUT.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
proximityRollOver | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OVER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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).
Elementem docelowym zdarzenia jest obiekt wskazany przez pisak lub obiekt macierzysty tego obiektu. Obiekt relatedObject jest obiektem, który poprzednio znajdował się pod pisakiem. Zdarzenia proximityRollOver są wywoływane kolejno w dół łańcucha obiektów macierzystych, zaczynając od obiektu macierzystego najwyższego poziomu, który nie jest obiektem głównym ani przodkiem obiektu relatedObject, a na wybranym obiekcie kończąc.
Celem zdarzenia proximityRollOver jest uproszczenie kodowania zachowań typu rollout dla kontenerów obiektów ekranowych z obiektami potomnymi. Wprowadzenie pisaka na obszar nad obiektem ekranowym lub obszar nad dowolnym z jego obiektów potomnych z obiektu niebędącego obiektem potomnym tego obiektu ekranowego wywołuje zdarzenie proximityRollOver. Jest to zachowanie inne niż w przypadku zdarzenia proximityOver, które jest wywoływane za każdym razem, gdy mysz znajdzie się na obszarze dowolnego obiektu potomnego kontenera obiektów ekranowych, nawet gdy mysz znajdowała się już nad innym obiektem potomnym tego kontenera.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku PROXIMITY_ROLL_OVER.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
releaseOutside | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.RELEASE_OUTSIDE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3.3, Flash Player 11.3 |
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. Jeżeli celem jest instancja SimpleButton, wówczas obiekt wyświetla obiekt wyświetlany upState. Jeżeli celem jest pole tekstowe możliwe do wybrania, wówczas pole tekstowe zakańcza wybór jako zachowanie domyślne.
type obiektu zdarzenia releaseOutside.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | false |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
clickCount | Liczba kliknięć myszą określająca, czy zdarzenie jest częścią sekwencji wielu kliknięć. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Element InteractiveObject, w przypadku którego naciśnięto przycisk urządzenia wskazującego, a następnie przesunięto wskaźnik poza wystąpienie i wtedy zwolniono przycisk. 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. |
rightClick | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.RIGHT_CLICK| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane, gdy użytkownik naciśnie i zwolni prawy przycisk urządzenia wskazującego nad tą samą instancją klasy InteractiveObject. Aby zaszło zdarzenie rightClick, wcześniej muszą wystąpić kolejno zdarzenia rightMouseDown i rightMouseUp. Obiekt docelowy musi być identyczny w dla obu tych zdarzeń. W innym przypadku zdarzenie rightClick nie występuje. Dowolna liczba innych zdarzeń myszy może wystąpić w dowolnym momencie pomiędzy zdarzeniami rightMouseDown i rightMouseUp; mimo tego zdarzenie rightClick wciąż występuje.
type obiektu zdarzenia rightClick.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | W przypadku zdarzeń kliknięcia prawym przyciskiem ta właściwość zawsze jest równa false. |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
rightMouseDown | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_DOWN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane, gdy użytkownik naciśnie przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject.
Definiuje wartość właściwościtype obiektu zdarzenia rightMouseDown.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | W przypadku zdarzeń kliknięcia prawym przyciskiem ta właściwość zawsze jest równa true. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
clickCount | Liczba kliknięć myszą określająca, czy zdarzenie jest częścią sekwencji wielu kliknięć. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
rightMouseUp | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_UP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Lite 4 |
Wywoływane, gdy użytkownik zwolni przycisk urządzenia wskazującego nad wystąpieniem klasy InteractiveObject.
Definiuje wartość właściwościtype obiektu zdarzenia rightMouseUp.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | true |
buttonDown | true, jeśli prawy przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie można anulować zachowania domyślnego. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
clickCount | Liczba kliknięć myszą określająca, czy zdarzenie jest częścią sekwencji wielu kliknięć. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
rollOut | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.ROLL_OUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik przesunie kursor poza wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego). Celem zdarzenia jest obiekt znajdujący się uprzednio pod urządzeniem wskazującym lub obiekt nadrzędny tego obiektu. Obiekt relatedObject jest obiektem, na który zostało przesunięte urządzenie wskazujące. Zdarzenia rollOut są wywoływane kolejno w górę nadrzędnego łańcucha obiektu, zaczynając od wybranego obiektu, a kończąc na najwyższym obiekcie nadrzędnym, który nie jest obiektem głównym lub obiektem przodka obiektu relatedObject.
Celem zdarzenia rollOut jest uproszczenie kodowania zachowań typu rollover dla kontenerów obiektów wyświetlanych z obiektami podrzędnymi. W momencie opuszczenia przez mysz obszaru obiektu wyświetlanego lub obszar któregoś z jego obiektów podrzędnych w celu przejścia do obiektu innego niż podrzędny, wówczas obiekt wyświetlany wywołuje zdarzenie rollOut. Jest to zachowanie inne niż w przypadku zdarzenia mouseOut, które jest wywoływane za każdym razem, gdy mysz opuszcza obszar dowolnego obiektu podrzędnego kontenera obiektów wyświetlanych, nawet gdy mysz pozostaje nad innym obiektem podrzędnym kontenera.
type obiektu zdarzenia rollOut.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | false |
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
relatedObject | Obiekt listy wyświetlania wskazywany teraz przez urządzenie wskazujące. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
rollOver | Zdarzenie |
flash.events.MouseEventwłaściwość MouseEvent.type =
flash.events.MouseEvent.ROLL_OVER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik przesunie kursor nad wystąpienie klasy InteractiveObject (za pomocą urządzenia wskazującego). Celem zdarzenia jest obiekt znajdujący się pod urządzeniem wskazującym lub obiekt nadrzędny tego obiektu. Obiekt relatedObject jest obiektem, który poprzednio znajdował się pod urządzeniem wskazującym. Zdarzenia rollover są wywoływane kolejno w dół nadrzędnego łańcucha obiektu, zaczynając od najwyższego obiektu nadrzędnego, który nie jest obiektem głównym ani obiektem przodka obiektu relatedObject, a na wybranym obiekcie kończąc.
Celem zdarzenia rollOver jest uproszczenie kodowania zachowań typu rollout dla kontenerów obiektów wyświetlanych z obiektami podrzędnymi. W chwili wprowadzenia myszy na obszar obiektu wyświetlanego lub obszar któregoś z jego obiektów podrzędnych z obiektu innego niż podrzędny obiekt wyświetlany wywołuje zdarzenie rollOver. Jest to zachowanie inne niż w przypadku zdarzenia mouseOver, które jest wywoływane za każdym razem, gdy mysz znajdzie się na obszarze dowolnego obiektu podrzędnego kontenera obiektów wyświetlanych, nawet gdy mysz znajdowała się już nad innym obiektem podrzędnym kontenera.
type obiektu zdarzenia rollOver.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows). |
bubbles | false |
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
relatedObject | Obiekt listy wyświetlania, na który wskazywało urządzenie wskazujące. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki), jeśli jest wyłączone blokowanie myszy. |
movementX | Zmiana współrzędnej poziomej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
movementY | Zmiana współrzędnej pionowej pozycji myszy od ostatniego zdarzenia myszy, jeśli jest włączone blokowanie myszy. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem wskazującym. 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. |
selectAll | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.SELECT_ALL| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
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. Zdarzenie jest wywoływane dla obiektu, który obecnie jest aktywny. Jeśli obiektem aktualnie aktywnym jest pole TextField, domyślnie działanie tego zdarzenia powoduje wybranie całej zawartości tego pola tekstowego.
StałaEvent.SELECT_ALL definiuje wartość właściwości type obiektu zdarzenia selectAll .
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 | Dowolna instancja klasy InteractiveObject z detektorem zarejestrowanym dla zdarzenia selectAll. |
Uwaga: Obiekty TextField nie wywołują zdarzeń clear, copy, cut, paste ani selectAll. Dla obiektów TextField polecenia Wytnij, Kopiuj, Wklej, Usuń i Zaznacz wszystko są zawsze dostępne w menu kontekstowym. Tych poleceń nie można usunąć z menu kontekstowego obiektów TextField. W przypadku obiektów TextField wybieranie tych poleceń (za pomocą odpowiadających im klawiszy) nie powoduje wywoływania zdarzeń clear, copy, cut, paste ani selectAll. Jednak inne klasy rozszerzające klasę InteractiveObject, łączenie z elementami zbudowanymi za pomocą mechanizmu Flash Text Engine (FTE), spowodują wywołanie tych zdarzeń w odpowiedzi na działania użytkownika takie jak używanie skrótów klawiaturowych i menu kontekstowych.
softKeyboardActivate | Zdarzenie |
flash.events.SoftKeyboardEventwłaściwość SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.6 |
Wywoływane bezpośrednio po uniesieniu klawiatury programowej.
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ń. |
Powiązane elementy interfejsu API
softKeyboardActivating | Zdarzenie |
flash.events.SoftKeyboardEventwłaściwość SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.6 |
Wywoływane bezpośrednio przed uniesieniem klawiatury programowej.
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ń. |
Powiązane elementy interfejsu API
softKeyboardDeactivate | Zdarzenie |
flash.events.SoftKeyboardEventwłaściwość SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.2, AIR 2.6 |
Wywoływane bezpośrednio po opuszczeniu klawiatury programowej.
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ń. |
Powiązane elementy interfejsu API
tabChildrenChange | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.TAB_CHILDREN_CHANGE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Wywoływane, gdy zmienia się wartość flagi tabChildren obiektu.
Event.TAB_CHILDREN_CHANGE definiuje wartość właściwości type obiektu zdarzenia tabChildrenChange.
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 | Obiekt, którego flaga tabChildren uległa zmianie. 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. |
tabEnabledChange | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.TAB_ENABLED_CHANGE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Wywoływane, gdy zmienia się flaga tabEnabled obiektu.
Event.TAB_ENABLED_CHANGE definiuje wartość właściwości type obiektu zdarzenia tabEnabledChange.
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 | Obiekt InteractiveObject, którego flaga tabEnabled uległa zmianie. 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. |
tabIndexChange | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.TAB_INDEX_CHANGE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Wywoływane, gdy zmienia się wartość właściwości tabIndex obiektu.
Event.TAB_INDEX_CHANGE definiuje wartość właściwości type obiektu zdarzenia tabIndexChange.
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 | Obiekt, którego wartość tabIndex uległa zmianie. 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. |
textInput | Zdarzenie |
flash.events.TextEventwłaściwość TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy użytkownik wprowadzi jeden lub większą liczbę znaków tekstu. To zdarzenie można wygenerować przy użyciu wielu różnych metod wprowadzania tekstu, w tym za pomocą standardowych klawiatur, edytora IME, systemów rozpoznawania głosu i mowy, a nawet przez wklejenie zwykłego tekstu, który nie będzie zawierał żadnych danych dotyczących formatowania czy stylu.
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. |
touchBegin | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.TOUCH_BEGIN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Wywoływane, gdy użytkownik zainicjuje kontakt z urządzeniem dotykowym (np. dotknie palcem ekranu dotykowego telefonu komórkowego lub tabletu). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie mouseDown.
W szczególności, jeśli użytkownik dotknie palcem ekranu dotykowego, instancja klasy InteractiveObject może wywołać zdarzenie mouseDown i/lub zdarzenie touchBegin, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseDown, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie touchBegin, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku TOUCH_BEGIN.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Przykład ( Sposób korzystania z tego przykładu )
TOUCH_BEGIN, TOUCH_MOVE i TOUCH_END. W miarę, jak punkt kontaktu przesuwa się po ekranie (onTouchMove), wyświetlane są (za pomocą funkcji trace) współrzędne x względem stołu montażowego. W parametrach Sprite.startTouchDrag funkcji onTouchBegin wartość touchPointID jest wartością przypisaną do obiektu zdarzenia. Parametr bounds to prostokąt definiujący granice nadrzędnego obiektu wyświetlanego (bg to obiekt wyświetlany zawierający obiekt MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Powiązane elementy interfejsu API
touchEnd | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.TOUCH_END| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Wywoływane, gdy użytkownik przerwie kontakt z urządzeniem dotykowym (np. uniesie palec z ekranu dotykowego telefonu komórkowego lub tabletu). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie mouseUp.
W szczególności, jeśli użytkownik uniesie palec z ekranu dotykowego, instancja klasy InteractiveObject może wywołać zdarzenie mouseUp i/lub zdarzenie touchEnd, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseUp, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie touchEnd, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku TOUCH_END.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Przykład ( Sposób korzystania z tego przykładu )
TOUCH_BEGIN, TOUCH_MOVE i TOUCH_END. W miarę, jak punkt kontaktu przesuwa się po ekranie (onTouchMove), wyświetlane są (za pomocą funkcji trace) współrzędne x względem stołu montażowego. W parametrach Sprite.startTouchDrag funkcji onTouchBegin wartość touchPointID jest wartością przypisaną do obiektu zdarzenia. Parametr bounds to prostokąt definiujący granice nadrzędnego obiektu wyświetlanego (bg to obiekt wyświetlany zawierający obiekt MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Powiązane elementy interfejsu API
touchMove | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.TOUCH_MOVE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Wywoływane, gdy użytkownik dotyka urządzenia. Wywołanie jest powtarzane w sposób ciągły do momentu usunięcia punktu kontaktu. To zdarzenie nie wymaga ruchu punktu kontaktu do wywołania.
Niektóre urządzenia mogą interpretować ten kontakt jako zdarzenie mouseMove. W szczególności, jeśli użytkownik przesunie palec po ekranie dotykowym, instancja klasy InteractiveObject może wywołać zdarzenie mouseMove i/lub zdarzenie touchMove, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseMove, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie touchMove, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku TOUCH_MOVE.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Przykład ( Sposób korzystania z tego przykładu )
TOUCH_BEGIN, TOUCH_MOVE i TOUCH_END. W miarę, jak punkt kontaktu przesuwa się po ekranie (onTouchMove), wyświetlane są (za pomocą funkcji trace) współrzędne x względem stołu montażowego. W parametrach Sprite.startTouchDrag funkcji onTouchBegin wartość touchPointID jest wartością przypisaną do obiektu zdarzenia. Parametr bounds to prostokąt definiujący granice nadrzędnego obiektu wyświetlanego (bg to obiekt wyświetlany zawierający obiekt MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Powiązane elementy interfejsu API
touchOut | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.TOUCH_OUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie mouseOut.
W szczególności, jeśli użytkownik przesunie palec po ekranie dotykowym, instancja klasy InteractiveObject może wywołać zdarzenie mouseOut i/lub zdarzenie touchOut, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOut, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie touchOut, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku TOUCH_OUT.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
touchOver | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.TOUCH_OVER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Wywoływane, gdy użytkownik przemieści punkt kontaktu nad wystąpienie klasy InteractiveObject na urządzeniu dotykowym (na przykład przeciągnie palcem z punktu poza obiektem ekranowym do punktu na obiekcie ekranowym na ekranie dotykowym telefonu komórkowego lub tabletu). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie mouseOver.
W szczególności, jeśli użytkownik przesunie palec nad instancję klasy InteractiveObject, instancja ta może wywołać zdarzenie mouseOver i/lub zdarzenie touchOver, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie mouseOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie touchOver, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku TOUCH_OVER.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
touchRollOut | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OUT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie rollOut.
W szczególności, jeśli użytkownik przesunie palec nad instancję klasy InteractiveObject, instancja ta może wywołać zdarzenie rollOut i/lub zdarzenie touchRollOut, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie rollOut, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie touchRollOut, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku TOUCH_ROLL_OUT.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
touchRollOver | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OVER| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie rollOver.
W szczególności, jeśli użytkownik przesunie palec nad instancję klasy InteractiveObject, instancja ta może wywołać zdarzenie rollOver i/lub zdarzenie touchRollOver, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie rollOver, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie touchRollOver, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku TOUCH_ROLL_OVER.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
touchTap | Zdarzenie |
flash.events.TouchEventwłaściwość TouchEvent.type =
flash.events.TouchEvent.TOUCH_TAP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Niektóre urządzenia mogą też zinterpretować ten kontakt jako zdarzenie click.
W szczególności, jeśli użytkownik stuknie palcem w instancję klasy InteractiveObject, instancja ta może wywołać zdarzenie click i/lub zdarzenie touchTap, o ile bieżące środowisko obsługuje ten gest. Należy wybrać sposób obsługi interakcji z użytkownikiem. Klasa flash.ui.Multitouch służy do zarządzania obsługą zdarzeń dotyku (włączenie obsługi gestów, obsługa prostych dotknięć punktowych lub wyłączenie zdarzeń dotyku, tak aby wywoływane były tylko zdarzenia myszy). Jeśli kod użytkownika będzie obsługiwał zdarzenie click, wówczas ten sam podprogram obsługi zdarzenia będzie działał zarówno na urządzeniu dotykowym, jak i na urządzeniu z myszą. Jeśli jednak kod użytkownika będzie obsługiwał zdarzenie touchTap, można zaprojektować podprogram obsługi zdarzenia tak, aby uwzględniał specyfikę interfejsu dotykowego i oferował użytkownikom bardziej wszechstronną obsługę. Można także obsługiwać każde z tych zdarzeń osobno, aby inaczej reagować na zdarzenia dotyku, a inaczej na zdarzenia myszy.
Uwaga: informacje o zgodności z poszczególnymi środowiskami zawiera opis klasy Multitouch.
Definiuje wartość właściwościtype dotyczącej obiektu zdarzenia dotyku TOUCH_TAP.
Wywołany obiekt TouchEvent ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
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ń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. 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. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Przykład ( Sposób korzystania z tego przykładu )
Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;
var mySprite:Sprite = new Sprite();
var myTextField:TextField = new TextField();
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);
mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);
function taphandler(e:TouchEvent): void {
myTextField.text = "I've been tapped";
myTextField.y = 50;
addChild(myTextField);
}
Powiązane elementy interfejsu API
InteractiveObjectExample, która z kolei wykorzystuje klasę ChildSprite do narysowania prostokąta, a następnie manipulacji nim w oparciu o różne zdarzenia myszy. Zadanie to jest realizowane przez wykonanie następujących kroków:
- W konstruktorze
InteractiveObjectExampletworzony jest nowy obiekt ChildSprite typu Sprite o nazwiechild, który wywołuje metodę konstruktora ChildSprite w celu narysowania figury oraz dodania dla niej zdarzeń myszy (tak jak jest to opisane w poniższych krokach). Obiektchildjest dodawany na szczyt listy wyświetlania na współrzędnych x = 0, y = 0. - W klasie
ChildSpritenależy zadeklarować właściwościsizeioverSize, które są później wykorzystywane w metodziedraw()oraz metodach MouseEvent. - Należy zadeklarować właściwości, które ustawiają kolor tła na pomarańczowy, kolor po najechaniu myszą na ciemnożółty, a kolor po naciśnięciu przycisku myszy na jasnoniebieski.
- W konstruktorze
ChildSpritepomarańczowy kwadrat jest rysowany przez zastosowanie metod z klasy Graphics oraz metodydraw(). - Konstruktor dodaje cztery metody detektora zdarzeń MouseEvent:
mouseOverHandler: przerysowuje większy kwadrat pikseli 60 x 60 koloru ciemno żółtego na oryginalnych współrzędnych.mouseOutHandler: przywraca kwadrat to oryginalnego rozmiaru i koloru.mouseDownHandler: przerysowuje większy kwadrat pikseli 60 x 60 koloru jasno niebieskiego na oryginalnych współrzędnych.mouseUpHandler: tak samo jak w przypadkumouseOverHandler.
package {
import flash.display.Sprite;
public class InteractiveObjectExample extends Sprite {
public function InteractiveObjectExample() {
var child:Sprite = new ChildSprite();
addChild(child);
}
}
}
import flash.display.Sprite;
import flash.events.MouseEvent;
class ChildSprite extends Sprite {
private var size:uint = 50;
private var overSize:uint = 60;
private var backgroundColor:uint = 0xFFCC00;
private var overColor:uint = 0xCCFF00;
private var downColor:uint = 0x00CCFF;
public function ChildSprite() {
buttonMode = true;
draw(size, size, backgroundColor);
addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
}
private function draw(w:uint, h:uint, bgColor:uint):void {
graphics.clear();
graphics.beginFill(bgColor);
graphics.drawRect(0, 0, w, h);
graphics.endFill();
}
public function mouseOverHandler(event:MouseEvent):void {
trace("mouseOverHandler");
draw(overSize, overSize, overColor);
}
public function mouseOutHandler(event:MouseEvent):void {
trace("mouseOutHandler");
draw(size, size, backgroundColor);
}
public function mouseDownHandler(event:MouseEvent):void {
trace("mouseDownHandler");
draw(overSize, overSize, downColor);
}
public function mouseUpHandler(event:MouseEvent):void {
trace("mouseUpHandler");
draw(overSize, overSize, overColor);
}
}
Tue Jun 12 2018, 12:06 PM Z