| Pakiet | flash.events |
| Klasa | public class GestureEvent |
| Dziedziczenie | GestureEvent  Event Object |
| Podklasy | PressAndTapGestureEvent, TransformGestureEvent |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Klasa Multitouch służy do określania funkcji bieżącego środowiska przeznaczonych do interakcji dotykowych, a także do zarządzania funkcjami obsługi interakcji dotykowych, jeśli bieżące środowisko obsługuje je.
Uwaga: Gdy obiekty są zagnieżdżone na liście wyświetlania, wówczas obiektami docelowymi dla zdarzeń dotyku są najgłębiej zagnieżdżone obiekty, które są widoczne na liście wyświetlania. Taki obiekt jest nazywany węzłem docelowym. Aby umożliwić obiektowi nadrzędnemu (obiekt zawierający węzeł docelowy na liście wyświetlania) węzła docelowego odbieranie powiadomień na temat zdarzeń dotyku, należy użyć metody EventDispatcher.addEventListener() w węźle nadrzędnym z parametrem type ustawionym na zdarzenie dotyku, które ma zostać wykryte.
Powiązane elementy interfejsu API
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| altKey : Boolean
Określa, czy klawisz Alt jest aktywny (true), czy nieaktywny (false). | GestureEvent | ||
 | bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | |
| cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | |
| commandKey : Boolean
Określa, czy klawisz Command jest aktywny (tylko na komputerach Mac). | GestureEvent | ||
| constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| controlKey : Boolean
Określa, czy klawisz Control jest aktywny w systemie Mac lub czy klawisz Ctrl jest aktywny w systemie Windows lub Linux. | GestureEvent | ||
| ctrlKey : Boolean
W systemach Windows lub Linux określa, czy klawisz Ctrl jest aktywny (true), czy nieaktywny (false). | GestureEvent | ||
| currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | |
| eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | |
| localX : Number
Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). | GestureEvent | ||
| localY : Number
Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). | GestureEvent | ||
| phase : String
Wartość z klasy GesturePhase wskazująca postęp gestu dotyku. | GestureEvent | ||
| shiftKey : Boolean
Określa, czy klawisz Shift jest aktywny (true), czy nieaktywny (false). | GestureEvent | ||
| stageX : Number [tylko do odczytu]
Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). | GestureEvent | ||
| stageY : Number [tylko do odczytu]
Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). | GestureEvent | ||
| target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | |
| type : String [tylko do odczytu]
Typ zdarzenia. | Event | |
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)
Tworzy obiekt Event, który zawiera informacje o zdarzeniach obejmujących wiele sekwencji ruchu i dotyku (np. naciśnięcie ekranu dotykowego jednocześnie dwoma palcami). | GestureEvent | ||
[przesłanianie]
Tworzy kopię obiektu GestureEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału. | GestureEvent | ||
|
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | |
|
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
[przesłanianie]
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu GestureEvent. | GestureEvent | ||
Odświeża ekran środowiska wykonawczego Flash po przetworzeniu zdarzenia gestu, jeśli lista wyświetlania została zmodyfikowana przez funkcję obsługi zdarzenia. | GestureEvent | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
| Stała | Zdefiniowane przez | ||
|---|---|---|---|
| GESTURE_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia gestu GESTURE_TWO_FINGER_TAP. | GestureEvent | ||
altKey | właściwość |
altKey:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Określa, czy klawisz Alt jest aktywny (true), czy nieaktywny (false). Obsługiwany tylko w systemach operacyjnych Windows i Linux.
Implementacja
public function get altKey():Boolean public function set altKey(value:Boolean):void commandKey | właściwość |
commandKey:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Określa, czy klawisz Command jest aktywny (tylko w systemach Mac).
W systemie Mac OS wartość właściwości commandKey jest taka sama, jak wartość właściwości ctrlKey. Ta właściwość ma zawsze wartość false w systemach Windows i Linux.
Implementacja
public function get commandKey():Boolean public function set commandKey(value:Boolean):voidcontrolKey | właściwość |
controlKey:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Określa, czy klawisz Control jest aktywny w systemie Mac lub czy klawisz Ctrl jest aktywny w systemie Windows lub Linux.
Implementacja
public function get controlKey():Boolean public function set controlKey(value:Boolean):voidctrlKey | właściwość |
ctrlKey:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
W systemach Windows lub Linux określa, czy klawisz Ctrl jest aktywny (true), czy nieaktywny (false). W systemie Macintosh określa, czy aktywny jest klawisz Control albo Command.
Implementacja
public function get ctrlKey():Boolean public function set ctrlKey(value:Boolean):voidlocalX | właściwość |
localY | właściwość |
phase | właściwość |
phase:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Wartość z klasy GesturePhase wskazująca postęp gestu dotyku. W przypadku większości gestów wartość jest równa begin, update lub end. W przypadku gestów machnięcia i stuknięcia dwoma palcami wartość fazy jest zawsze równa all — od momentu wywołania zdarzenia. Za pomocą tej wartości można określić, czy funkcja obsługi zdarzenia reaguje na złożoną interakcję ze strony użytkownika, czy reaguje na różne sposoby w zależności od aktualnej fazy gestu obejmującego wiele sekwencji ruchu i dotyku (np. rozszerzanie, przenoszenie i upuszczanie, gdy użytkownik dotyka i przeciąga obiekty na ekranie).
Implementacja
public function get phase():String public function set phase(value:String):voidPowiązane elementy interfejsu API
shiftKey | właściwość |
stageX | właściwość |
stageX:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). Ta właściwość jest obliczana po ustawieniu wartości właściwości localX.
Implementacja
public function get stageX():NumberstageY | właściwość |
stageY:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). Ta właściwość jest obliczana po ustawieniu wartości właściwości localY.
Implementacja
public function get stageY():NumberGestureEvent | () | Konstruktor |
public function GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Tworzy obiekt Event, który zawiera informacje o zdarzeniach obejmujących wiele sekwencji ruchu i dotyku (np. naciśnięcie ekranu dotykowego jednocześnie dwoma palcami). Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.
Parametrytype:String — Typ zdarzenia. Obsługiwana wartość: GestureEvent.GESTURE_TWO_FINGER_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
phase:String (default = null) | |
localX:Number (default = 0) | |
localY:Number (default = 0) | |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) |
Powiązane elementy interfejsu API
clone | () | metoda |
override public function clone():Event| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Tworzy kopię obiektu GestureEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.
ZwracaEvent — Nowy obiekt GestureEvent z wartościami właściwości zgodnymi z oryginałem.
|
toString | () | metoda |
override public function toString():String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu GestureEvent. Format ciągu znaków jest następujący:
[GestureEvent type=wartość bubbles=wartość cancelable=wartość ... ]
String — Ciąg znaków, który zawiera wszystkie właściwości obiektu GestureEvent.
|
updateAfterEvent | () | metoda |
public function updateAfterEvent():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Odświeża ekran środowiska Flash po przetworzeniu zdarzenia gestu, jeśli lista wyświetlana została zmodyfikowana przez funkcję obsługi zdarzenia.
GESTURE_TWO_FINGER_TAP | Stała |
public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiuje wartość właściwości type obiektu zdarzenia gestu GESTURE_TWO_FINGER_TAP
Wywołany obiekt GestureEvent 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 | (Tylko w środowisku AIR) (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 stuknięcia dwoma palcami ta wartość zawsze jest równa all i odpowiada wartości GesturePhase.ALL, czyli fazie rozpoczynającej się z chwilą wywołania zdarzenia. |
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). |
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
GESTURE_TWO_FINGER_TAP. Gdy użytkownik wykonuje gest stuknięcia dwoma palcami, obiekt mySprite obraca się, a w polu myTextField wpisywana jest faza all, czyli jedyna faza obsługi zdarzeń stuknięcia dwoma palcami. Inne gesty z klasy TransformGestureEvent obsługują fazy begin, update i end.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onTwoFingerTap(evt:GestureEvent):void {
evt.target.rotation -= 45;
myTextField.text = evt.phase; //"all"
}
Tue Jun 12 2018, 12:06 PM Z