Paket | flash.events |
Klasse | public class TransformGestureEvent |
Vererbung | TransformGestureEvent GestureEvent Event Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Ein Gerät oder Betriebssystem interpretiert die Gesteneingabe. Verschiedene Geräte oder Betriebssysteme haben unterschiedliche Anforderungen für die einzelnen Gestentypen. Eine Swipe-Geste auf einem Gerät kann andere Eingabebewegungen erfordern als eine Swipe-Geste auf einem anderen Gerät. Wie das Gerät oder Betriebssystem Berührungen als eine bestimmte Geste interpretiert, können Sie der Dokumentation der jeweiligen Hardware oder des Betriebssystems entnehmen.
Stellen Sie mithilfe der Multitouch-Klasse fest, welche Berührungsinteraktionen die aktuelle Umgebung unterstützt, und verwalten Sie die ggf. unterstützten Berührungsinteraktionen.
Hinweis: Wenn Objekte auf der Anzeigeliste verschachtelt sind, zielen Berührungsereignisse auf das am weitesten verschachtelte Objekt, das auf der Anzeigeliste zu sehen ist. Dieses Objekt wird als Zielknoten bezeichnet. Damit der Vorfahre des Knotens (ein Objekt in der Anzeigeliste, das den Zielknoten enthält) über ein Berührungsereignis benachrichtigt wird, verwenden Sie EventDispatcher.addEventListener()
für den Vorfahrenknoten. Dabei sollte der type-Parameter auf das Berührungsereignis gesetzt werden, das Sie erkennen möchten.
Während der Benutzer das Gerät berührt, sind die scale-, rotation- und offset-Eigenschaft des TransformGestureEvent-Objekts inkrementelle Werte aus dem vorherigen Gestenereignis. Wenn eine Geste zum Beispiel ein Anzeigeobjekt vergrößert, ändern sich die scale-Werte nacheinander vielleicht auf 1.03
, 1.01
, 1.01
, 1.02
und zeigen damit an, dass das Anzeigeobjekt beim Ende der Geste das 1,0717-Fache der ursprünglichen Größe aufweist.
Für TransformGestureEvent-Objekte werden Eigenschaften, die von der aktuellen Geste nicht geändert werden, auf Identitätswerte gesetzt. Eine Bildlaufgeste weist zum Beispiel keine Dreh- oder Skalierungstransformation auf, weshalb der rotation
-Wert des Ereignisobjekts 0
ist und die Eigenschaften scaleX
und scaleY
den Wert 1
haben.
Verwandte API-Elemente
flash.events.TouchEvent
flash.events.GestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Eigenschaft | Definiert von | ||
---|---|---|---|
altKey : Boolean
Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist. | GestureEvent | ||
bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | ||
cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | ||
commandKey : Boolean
Gibt an, ob die Befehlstaste aktiviert ist (nur Mac). | GestureEvent | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
controlKey : Boolean
Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist. | GestureEvent | ||
ctrlKey : Boolean
Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist. | GestureEvent | ||
currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | ||
eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | ||
localX : Number
Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. | GestureEvent | ||
localY : Number
Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. | GestureEvent | ||
offsetX : Number
Die horizontale Versetzung des Anzeigeobjekts seit dem vorherigen Gestenereignis. | TransformGestureEvent | ||
offsetY : Number
Die vertikale Versetzung des Anzeigeobjekts seit dem vorherigen Gestenereignis. | TransformGestureEvent | ||
phase : String
Ein Wert aus der GesturePhase-Klasse, die den Fortschritt der Berührungsgeste angibt. | GestureEvent | ||
rotation : Number
Der aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad. | TransformGestureEvent | ||
scaleX : Number
Die horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. | TransformGestureEvent | ||
scaleY : Number
Die vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. | TransformGestureEvent | ||
shiftKey : Boolean
Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist. | GestureEvent | ||
stageX : Number [schreibgeschützt]
Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. | GestureEvent | ||
stageY : Number [schreibgeschützt]
Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. | GestureEvent | ||
target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | ||
type : String [schreibgeschützt]
Der Ereignistyp. | Event | ||
velocity : Number
Die Geschwindigkeit des Transformationsgestenereignisses in Pixel pro Sekunde. | TransformGestureEvent |
Methode | Definiert von | ||
---|---|---|---|
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)
Erstellt ein Event-Objekt, das Informationen zu komplexen Multitouch-Ereignissen enthält, zum Beispiel, wenn ein Benutzer seinen Finger über einen Bildschirm bewegt. | TransformGestureEvent | ||
[override]
Erstellt eine Kopie des TransformGestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. | TransformGestureEvent | ||
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
[override]
Gibt einen String zurück, der alle Eigenschaften des TransformGestureEvent-Objekts enthält. | TransformGestureEvent | ||
Aktualisiert die Anzeige der Flash-Laufzeitumgebung nach der Verarbeitung des Gestenereignisses, für den Fall, dass die Anzeigeliste von der Ereignisprozedur geändert wurde. | GestureEvent | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Konstante | Definiert von | ||
---|---|---|---|
GESTURE_DIRECTIONAL_TAP : String = "gestureDirectionalTap" [statisch]
Definiert den Wert der type-Eigenschaft eines GESTURE_DIRECTIONAL_TAP-Berührungsereignisobjekts. | TransformGestureEvent | ||
GESTURE_PAN : String = "gesturePan" [statisch]
Definiert den Wert der type-Eigenschaft eines GESTURE_PAN-Berührungsereignisobjekts. | TransformGestureEvent | ||
GESTURE_ROTATE : String = "gestureRotate" [statisch]
Definiert den Wert der type-Eigenschaft eines GESTURE_ROTATE-Berührungsereignisobjekts. | TransformGestureEvent | ||
GESTURE_SWIPE : String = "gestureSwipe" [statisch]
Definiert den Wert der type-Eigenschaft eines GESTURE_SWIPE-Berührungsereignisobjekts. | TransformGestureEvent | ||
GESTURE_ZOOM : String = "gestureZoom" [statisch]
Definiert den Wert der type-Eigenschaft eines GESTURE_ZOOM-Berührungsereignisobjekts. | TransformGestureEvent |
offsetX | Eigenschaft |
offsetY | Eigenschaft |
rotation | Eigenschaft |
rotation:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Der aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad.
Implementierung
public function get rotation():Number
public function set rotation(value:Number):void
scaleX | Eigenschaft |
scaleY | Eigenschaft |
velocity | Eigenschaft |
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)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Erstellt ein Event-Objekt, das Informationen zu komplexen Multitouch-Ereignissen enthält, zum Beispiel, wenn ein Benutzer seinen Finger über einen Bildschirm bewegt. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
Parametertype:String — Der Ereignistyp. Mögliche Werte sind: TransformGestureEvent.GESTURE_PAN , TransformGestureEvent.GESTURE_ROTATE , TransformGestureEvent.GESTURE_SWIPE und TransformGestureEvent.GESTURE_ZOOM .
| |
bubbles:Boolean (default = true ) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt.
| |
cancelable:Boolean (default = false ) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann.
| |
phase:String (default = null ) — Dieser Wert verfolgt den Anfang, den Fortschritt und das Ende einer Berührungsgeste. Mögliche Werte sind: GesturePhase.BEGIN , GesturePhase.END und GesturePhase.UPDATE .
| |
localX:Number (default = 0 ) — Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.
| |
localY:Number (default = 0 ) — Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.
| |
scaleX:Number (default = 1.0 ) — Die horizontale Skalierung des Anzeigeobjekts.
| |
scaleY:Number (default = 1.0 ) — Die vertikale Skalierung des Anzeigeobjekts.
| |
rotation:Number (default = 0 ) — Der aktuelle Drehwinkel des Anzeigeobjekt entlang der z-Achse in Grad.
| |
offsetX:Number (default = 0 ) — Die horizontale Versetzung des Anzeigeobjekts von seiner ursprünglichen Position.
| |
offsetY:Number (default = 0 ) — Die vertikale Versetzung des Anzeigeobjekts von seiner ursprünglichen Position.
| |
ctrlKey:Boolean (default = false ) — (Nur AIR) Die Geschwindigkeit der Transformationsgeste in Pixel pro Sekunde.
| |
altKey:Boolean (default = false ) — Unter Windows oder Linux wird damit angezeigt, ob die Strg-Taste aktiviert ist. Unter Mac OS wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist.
| |
shiftKey:Boolean (default = false ) — Gibt an, ob die Alt-Taste aktiviert ist (nur Windows oder Linux).
| |
commandKey:Boolean (default = false ) — Gibt an, ob der Umschalttasten-Modifizierer aktiviert ist.
| |
controlKey:Boolean (default = false ) — (nur AIR); gibt an, ob die Befehlstaste aktiviert ist (nur Mac). Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte.
| |
velocity:Number (default = 0 ) — (nur AIR); gibt an, ob die Ctrl- oder Strg-Taste aktiviert ist. Dieser Parameter gilt nur für Adobe AIR. Setzen Sie ihn nicht für Flash Player-Inhalte.
|
Verwandte API-Elemente
clone | () | Methode |
override public function clone():Event
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Erstellt eine Kopie des TransformGestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
RückgabewerteEvent — Ein neues TransformGestureEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
|
toString | () | Methode |
override public function toString():String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Gibt einen String zurück, der alle Eigenschaften des TransformGestureEvent-Objekts enthält. Der String liegt im folgenden Format vor:
[TransformGestureEvent type=Wert bubbles=Wert cancelable=Wert ... ]
String — Ein String, der alle Eigenschaften des TransformGestureEvent-Objekts enthält.
|
GESTURE_DIRECTIONAL_TAP | Konstante |
public static const GESTURE_DIRECTIONAL_TAP:String = "gestureDirectionalTap"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 24, Flash Lite 4 |
Definiert den Wert der type
-Eigenschaft eines GESTURE_DIRECTIONAL_TAP
-Berührungsereignisobjekts.
Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:
Eigenschaft | Wert |
---|---|
altKey | true , wenn die Alt-Taste aktiviert ist (Windows oder Linux). |
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
commandKey | true unter Mac OS, falls die Befehlstaste aktiviert ist; false , wenn sie deaktiviert ist. Unter Windows immer false |
controlKey | true , wenn die Strg- oder Ctrl-Taste aktiv ist; false , wenn sie nicht aktiv ist. |
ctrlKey | true unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
phase | Die aktuelle Phase im Ereignisablauf. Für Swipe-Ereignisse ist dieser Wert immer all entsprechend dem Wert GesturePhase.ALL , nachdem dieses Ereignis abgesetzt wurde. |
localX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. Für Richtungstippengesten liegt dieser Wert in der Bildschirmmitte. |
localY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. Für Richtungstippengesten liegt dieser Wert in der Bildschirmmitte. |
scaleX | Die horizontale Skalierung des Anzeigeobjekts. Für Richtungstippengesten beträgt dieser Wert 1 . |
scaleY | Die vertikale Skalierung des Anzeigeobjekts. Für Richtungstippengesten beträgt dieser Wert 1 . |
rotation | Der aktuelle Drehwinkel des Anzeigeobjekt entlang der z-Achse in Grad. Für Richtungstippengesten beträgt dieser Wert 0 . |
offsetX | Gibt die horizontale Richtung an: 1 für „nach rechts“ und -1 für „nach links“. |
offsetY | Gibt die vertikale Richtung an: 1 für „nach unten“ und -1 für „nach oben“. |
Geschwindigkeit | Gibt die Geschwindigkeit der Swipe-Geste in Pixel pro Sekunde an (nur AIR). |
shiftKey | true , wenn die Umschalttaste aktiv ist; false , wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Verwandte API-Elemente
GESTURE_PAN | Konstante |
public static const GESTURE_PAN:String = "gesturePan"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type
-Eigenschaft eines GESTURE_PAN
-Berührungsereignisobjekts.
Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:
Eigenschaft | Wert |
---|---|
altKey | true , wenn die Alt-Taste aktiviert ist (Windows oder Linux). |
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
commandKey | true unter Mac OS, falls die Befehlstaste aktiviert ist; false , wenn sie deaktiviert ist. Unter Windows immer false |
controlKey | true , wenn die Strg- oder Ctrl-Taste aktiv ist; false , wenn sie nicht aktiv ist. |
ctrlKey | true unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
phase | Die aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse. |
localX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. |
localY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. |
scaleX | Die horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. Für Bildlaufgesten ist dieser Wert 1 . |
scaleY | Die vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. Für Bildlaufgesten ist dieser Wert 1 . |
rotation | Der aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad. Für Bildlaufgesten ist dieser Wert 0 . |
offsetX | Die horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis. |
offsetY | Die vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis. |
Geschwindigkeit | Die Geschwindigkeit des Gestenereignisses in Pixel pro Sekunde (nur AIR). Für Bildlaufgesten beträgt dieser Wert 0 . |
shiftKey | true , wenn die Umschalttaste aktiv ist; false , wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
GESTURE_PAN
-Ereignisse. Während der Benutzer eine Bildlaufgeste auf dem berührungsempfindlichen Gerät ausführt, wird in myTextField die aktuelle Phase angezeigt.
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 | Konstante |
public static const GESTURE_ROTATE:String = "gestureRotate"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type
-Eigenschaft eines GESTURE_ROTATE
-Berührungsereignisobjekts.
Während dieses Ereignisses enthält die rotation
-Eigenschaft den Drehwinkel. Die Drehwerte lauten wie folgt:
- 0 bis 180 Grad für die Drehung im Uhrzeigersinn
- -180 bis 0 Grad für die Drehung gegen den Uhrzeigersinn
Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:
Eigenschaft | Wert |
---|---|
altKey | true , wenn die Alt-Taste aktiviert ist (Windows oder Linux). |
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
commandKey | true unter Mac OS, falls die Befehlstaste aktiviert ist; false , wenn sie deaktiviert ist. Unter Windows immer false |
controlKey | true , wenn die Strg- oder Ctrl-Taste aktiv ist; false , wenn sie nicht aktiv ist. |
ctrlKey | true unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
phase | Die aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse. |
localX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. |
localY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. |
scaleX | Die horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. |
scaleY | Die vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. |
rotation | Der aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad. |
offsetX | Die horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis. |
offsetY | Die vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis. |
Geschwindigkeit | Die Geschwindigkeit des Gestenereignisses in Pixel pro Sekunde (nur AIR). Für Drehgesten beträgt dieser Wert 0 . |
shiftKey | true , wenn die Umschalttaste aktiv ist; false , wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
GESTURE_ROTATE
-Ereignisse. Während der Benutzer eine Drehgeste auf dem berührungsempfindlichen Gerät ausführt, dreht sich mySprite und in myTextField wird die aktuelle Phase angezeigt.
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 | Konstante |
public static const GESTURE_SWIPE:String = "gestureSwipe"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type
-Eigenschaft eines GESTURE_SWIPE
-Berührungsereignisobjekts.
Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:
Eigenschaft | Wert |
---|---|
altKey | true , wenn die Alt-Taste aktiviert ist (Windows oder Linux). |
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
commandKey | true unter Mac OS, falls die Befehlstaste aktiviert ist; false , wenn sie deaktiviert ist. Unter Windows immer false |
controlKey | true , wenn die Strg- oder Ctrl-Taste aktiv ist; false , wenn sie nicht aktiv ist. |
ctrlKey | true unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
phase | Die aktuelle Phase im Ereignisablauf. Für Swipe-Ereignisse ist dieser Wert immer all entsprechend dem Wert GesturePhase.ALL , nachdem dieses Ereignis abgesetzt wurde. |
localX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. |
localY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. |
scaleX | Die horizontale Skalierung des Anzeigeobjekts. Für Swipe-Gesten ist dieser Wert 1 |
scaleY | Die vertikale Skalierung des Anzeigeobjekts. Für Swipe-Gesten ist dieser Wert 1 |
rotation | Der aktuelle Drehwinkel des Anzeigeobjekt entlang der z-Achse in Grad. Für Swipe-Gesten ist dieser Wert 0 |
offsetX | Gibt die horizontale Richtung an: 1 für „nach rechts“ und -1 für „nach links“. |
offsetY | Gibt die vertikale Richtung an: 1 für „nach unten“ und -1 für „nach oben“. |
Geschwindigkeit | Gibt die Geschwindigkeit der Swipe-Geste in Pixel pro Sekunde an (nur AIR). Für den Rest beträgt dieser Wert 0 . |
shiftKey | true , wenn die Umschalttaste aktiv ist; false , wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
GESTURE_SWIPE
-Ereignisse. Während der Benutzer eine Swipe-Geste auf dem berührungsempfindlichen Gerät ausführt, wird myTextField mit der Phase all
ausgefüllt, welche die einzige Phase für Swipe-Ereignisse ist.
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 | Konstante |
public static const GESTURE_ZOOM:String = "gestureZoom"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type
-Eigenschaft eines GESTURE_ZOOM
-Berührungsereignisobjekts.
Das abgesetzte TransformGestureEvent-Objekt hat folgende Eigenschaften:
Eigenschaft | Wert |
---|---|
altKey | true , wenn die Alt-Taste aktiviert ist (Windows oder Linux). |
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
commandKey | true unter Mac OS, falls die Befehlstaste aktiviert ist; false , wenn sie deaktiviert ist. Unter Windows immer false |
controlKey | true , wenn die Strg- oder Ctrl-Taste aktiv ist; false , wenn sie nicht aktiv ist. |
ctrlKey | true unter Windows oder Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
phase | Die aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse. |
localX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. |
localY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht. |
scaleX | Die horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. |
scaleY | Die vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. |
rotation | Der aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad. |
offsetX | Die horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis. |
offsetY | Die vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis. |
Geschwindigkeit | Die Geschwindigkeit des Gestenereignisses in Pixel pro Sekunde (nur AIR). Für Zoom-Gesten beträgt dieser Wert 0 . |
shiftKey | true , wenn die Umschalttaste aktiv ist; false , wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz unter dem Touchpen oder Finger. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
GESTURE_ZOOM
-Ereignisse. Während der Benutzer eine Zoom-Geste auf dem berührungsempfindlichen Gerät ausführt, wird in myTextField die aktuelle Phase angezeigt.
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
-Ereignisse. Während der Benutzer eine Drehgeste auf dem berührungsempfindlichen Gerät ausführt, dreht sich mySprite und in myTextField wird die aktuelle Phase angezeigt.
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, 10:04 AM Z