Pakiet | flash.events |
Klasa | public class TransformGestureEvent |
Dziedziczenie | TransformGestureEvent GestureEvent Event Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Gesty interpretowane są przez urządzenie lub system operacyjny. Dlatego różne urządzenia lub systemy operacyjne mogą mieć różne wymagania w odniesieniu do poszczególnych typów gestów. Machnięcie na jednym urządzeniu może wymagać wykonania innego ruchu niż na innym. Sposoby interpretacji kontaktu z urządzeniem wejściowym jako konkretnych gestów opisane są w dokumentacji sprzętu lub systemu operacyjnego.
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.
Gdy użytkownik utrzymuje kontekst z urządzeniem, wówczas właściwości skali, rotacji i przesunięcia obiektu TransformGestureEvent to wartości krokowe wywodzące się z poprzedniego zdarzenia gestu. Na przykład: w miarę, jak gest zwiększa wielkość obiektu ekranowego, skala może przyjmować kolejno takie wartości: 1,03
, 1,01
, 1,01
, 1,02
, co wskazuje, że do końca gestu początkowa wielkość obiektu ekranowego została zmieniona o skalę 1,0717.
Właściwości obiektów TransformGestureEvent, które nie zostały zmodyfikowane przez bieżący gest, otrzymują wartości tożsamościowe. Na przykład gest panoramowania nie powoduje obrotu ani zmiany skali, dlatego wartość właściwości rotation
obiektu zdarzenia wynosi 0
, a właściwości scaleX
i scaleY
otrzymują wartości 1
.
Powiązane elementy interfejsu API
flash.events.TouchEvent
flash.events.GestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
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 | ||
offsetX : Number
Translacja pozioma obiektu ekranowego od poprzedniego zdarzenia gestu. | TransformGestureEvent | ||
offsetY : Number
Translacja pionowa obiektu ekranowego od poprzedniego zdarzenia gestu. | TransformGestureEvent | ||
phase : String
Wartość z klasy GesturePhase wskazująca postęp gestu dotyku. | GestureEvent | ||
rotation : Number
Bieżący stopień obrotu (w stopniach) obiektu ekranowego wzdłuż osi Z, od poprzedniego zdarzenia gestu. | TransformGestureEvent | ||
scaleX : Number
Skala pozioma obiektu ekranowego od poprzedniego zdarzenia gestu. | TransformGestureEvent | ||
scaleY : Number
Skala pionowa obiektu ekranowego od poprzedniego zdarzenia gestu. | TransformGestureEvent | ||
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 | ||
velocity : Number
Szybkość zdarzenia gestu przekształcenia wyrażona w pikselach na sekundę. | TransformGestureEvent |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
TransformGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, scaleX:Number = 1.0, scaleY:Number = 1.0, rotation:Number = 0, offsetX:Number = 0, offsetY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, velocity:Number = 0)
Tworzy obiekt Event, który zawiera informacje dotyczące złożonych zdarzeń obejmujących wiele ruchów, takich jak przesuwanie palca po ekranie. | TransformGestureEvent | ||
[przesłanianie]
Tworzy kopię obiektu TransformGestureEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału. | TransformGestureEvent | ||
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 TransformGestureEvent. | TransformGestureEvent | ||
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_DIRECTIONAL_TAP : String = "gestureDirectionalTap" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku GESTURE_DIRECTIONAL_TAP. | TransformGestureEvent | ||
GESTURE_PAN : String = "gesturePan" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku GESTURE_PAN. | TransformGestureEvent | ||
GESTURE_ROTATE : String = "gestureRotate" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku GESTURE_ROTATE. | TransformGestureEvent | ||
GESTURE_SWIPE : String = "gestureSwipe" [statyczny]
Definiuje wartość właściwości type obiektu zdarzenia dotyku GESTURE_SWIPE. | TransformGestureEvent | ||
GESTURE_ZOOM : String = "gestureZoom" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku GESTURE_ZOOM. | TransformGestureEvent |
offsetX | właściwość |
offsetY | właściwość |
rotation | właściwość |
rotation:Number
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Bieżący stopień obrotu (w stopniach) obiektu ekranowego wzdłuż osi Z, od poprzedniego zdarzenia gestu.
Implementacja
public function get rotation():Number
public function set rotation(value:Number):void
scaleX | właściwość |
scaleY | właściwość |
velocity | właściwość |
TransformGestureEvent | () | Konstruktor |
public function TransformGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, scaleX:Number = 1.0, scaleY:Number = 1.0, rotation:Number = 0, offsetX:Number = 0, offsetY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, velocity:Number = 0)
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 dotyczące złożonych zdarzeń obejmujących wiele ruchów, takich jak przesuwanie palca po ekranie. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.
Parametrytype:String — Typ zdarzenia. Możliwe wartości to: TransformGestureEvent.GESTURE_PAN , TransformGestureEvent.GESTURE_ROTATE , TransformGestureEvent.GESTURE_SWIPE oraz TransformGestureEvent.GESTURE_ZOOM .
| |
bubbles:Boolean (default = true ) — Określa, czy obiekt Event uczestniczy w fazie propagacji przepływu zdarzeń.
| |
cancelable:Boolean (default = false ) — Określa, czy obiekt Event może być anulowany.
| |
phase:String (default = null ) — Te wartości śledzą początek, postęp i koniec gestu. Możliwe wartości: GesturePhase.BEGIN , GesturePhase.END i GesturePhase.UPDATE .
| |
localX:Number (default = 0 ) — Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego obiektu ekranowego).
| |
localY:Number (default = 0 ) — Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego obiektu ekranowego).
| |
scaleX:Number (default = 1.0 ) — Skala pozioma obiektu ekranowego.
| |
scaleY:Number (default = 1.0 ) — Skala pionowa obiektu ekranowego.
| |
rotation:Number (default = 0 ) — Bieżący stopień obrotu obiektu ekranowego wzdłuż osi Z.
| |
offsetX:Number (default = 0 ) — Przesunięcie obiektu ekranowego w poziomie, z położenia oryginalnego.
| |
offsetY:Number (default = 0 ) — Przesunięcie obiektu ekranowego w pionie, z położenia oryginalnego.
| |
ctrlKey:Boolean (default = false ) — (Tylko środowisko AIR) Szybkość gestu przekształcenia wyrażona w pikselach na sekundę.
| |
altKey:Boolean (default = false ) — W systemie Windows lub Linux określa, czy klawisz Ctrl jest aktywny. W systemie Mac określa, czy aktywny jest klawisz Ctrl lub Command.
| |
shiftKey:Boolean (default = false ) — Określa, czy klawisz Alt jest aktywny (tylko w systemach Windows i Linux).
| |
commandKey:Boolean (default = false ) — Określa, czy klawisz Shift jest aktywny.
| |
controlKey:Boolean (default = false ) — (Tylko w środowisku AIR) Wskazuje, czy klawisz Command jest aktywny (tylko w systemach Mac). Ten parametr jest przeznaczony tylko dla środowiska Adobe AIR; nie należy go ustawiać dla treści programu Flash Player.
| |
velocity:Number (default = 0 ) — (Tylko środowisko AIR) Określa, czy klawisz Control lub Ctrl jest aktywny. Ten parametr jest przeznaczony tylko dla środowiska Adobe AIR. Nie należy go ustawiać dla zawartości programu Flash Player.
|
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 TransformGestureEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.
ZwracaEvent — Nowy obiekt TransformGestureEvent 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 TransformGestureEvent. Format ciągu znaków jest następujący:
[TransformGestureEvent type=wartość bubbles=wartość cancelable=wartość ... ]
String — Ciąg znaków, który zawiera wszystkie właściwości obiektu TransformGestureEvent.
|
GESTURE_DIRECTIONAL_TAP | Stała |
public static const GESTURE_DIRECTIONAL_TAP:String = "gestureDirectionalTap"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 24, Flash Lite 4 |
Definiuje wartość właściwości type
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
GESTURE_PAN | Stała |
public static const GESTURE_PAN:String = "gesturePan"
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 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. |
Powiązane elementy interfejsu API
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"; } }
GESTURE_ROTATE | Stała |
public static const GESTURE_ROTATE:String = "gestureRotate"
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
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. |
Powiązane elementy interfejsu API
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"; } }
GESTURE_SWIPE | Stała |
public static const GESTURE_SWIPE:String = "gestureSwipe"
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 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. |
Powiązane elementy interfejsu API
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; }
GESTURE_ZOOM | Stała |
public static const GESTURE_ZOOM:String = "gestureZoom"
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
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. |
Powiązane elementy interfejsu API
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"; } }
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"; } }
package { import flash.display.Bitmap; import flash.display.Sprite; import flash.events.TransformGestureEvent; import flash.text.TextField; import flash.text.TextFormat; import flash.ui.Multitouch; import flash.ui.MultitouchInputMode; [SWF(width=320, height=460, frameRate=24, backgroundColor=0x000000)] public class TransformGestureExample2 extends Sprite { [Embed(source="african_elephant.jpg")] public var ElephantImage:Class; public var scaleDebug:TextField; public var rotateDebug:TextField; public function TransformGestureExample2() { // Debug var tf:TextFormat = new TextFormat(); tf.color = 0xffffff; tf.font = "Helvetica"; tf.size = 11; this.scaleDebug = new TextField(); this.scaleDebug.width = 310; this.scaleDebug.defaultTextFormat = tf; this.scaleDebug.x = 2; this.scaleDebug.y = 2; this.stage.addChild(this.scaleDebug); this.rotateDebug = new TextField(); this.rotateDebug.width = 310; this.rotateDebug.defaultTextFormat = tf; this.rotateDebug.x = 2; this.rotateDebug.y = 15; this.stage.addChild(this.rotateDebug); var elephantBitmap:Bitmap = new ElephantImage(); var elephant:Sprite = new Sprite(); elephant.addChild(elephantBitmap); elephant.x = 160; elephant.y = 230; elephantBitmap.x = (300 - (elephantBitmap.bitmapData.width / 2)) * -1; elephantBitmap.y = (400 - (elephantBitmap.bitmapData.height / 2)) *-1; this.addChild(elephant); Multitouch.inputMode = MultitouchInputMode.GESTURE; elephant.addEventListener(TransformGestureEvent.GESTURE_ZOOM, onZoom); elephant.addEventListener(TransformGestureEvent.GESTURE_ROTATE, onRotate); } private function onZoom(e:TransformGestureEvent):void { this.scaleDebug.text = (e.scaleX + ", " + e.scaleY); var elephant:Sprite = e.target as Sprite; elephant.scaleX *= e.scaleX; elephant.scaleY *= e.scaleY; } private function onRotate(e:TransformGestureEvent):void { var elephant:Sprite = e.target as Sprite; this.rotateDebug.text = String(e.rotation); elephant.rotation += e.rotation; } } }
Tue Jun 12 2018, 12:06 PM Z