ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.events 

TransformGestureEvent  - AS3

Paketflash.events
Klassepublic class TransformGestureEvent
VererbungTransformGestureEvent Inheritance GestureEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2, Flash Lite 4

Die TransformGestureEvent-Klasse ermöglicht die Verarbeitung komplexer Bewegungseingabeereignisse (zum Beispiel das Bewegen von Fingern über einen Touchscreen), die das Gerät oder Betriebssystem als Geste interpretiert. Eine Geste kann einen oder mehrere Berührungspunkte aufweisen. Wenn ein Benutzer mit einem Gerät mit Touchscreen, zum Beispiel Mobiltelefon oder Tablet, interagiert, setzt er normalerweise einen Finger oder Touchpen auf den Bildschirm und bewegt ihn. Mithilfe der GestureEvent-, PressAndTapGestureEvent- und TransformGestureEvent-Klasse können Sie Anwendungen entwickeln, die auf diese Benutzerinteraktion reagieren. Erstellen Sie mit den hier oder in den verwandten GestureEvent- und TouchEvent-Klassen definierten Ereignistypen Ereignis-Listener. Verwenden Sie außerdem die Eigenschaften und Methoden dieser Klassen, um Ereignisprozeduren zu konstruieren, die auf die Berührung des Benutzers mit dem Gerät reagieren.

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.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedaltKey : Boolean
Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist.
GestureEvent
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inherited    commandKey : Boolean
Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).
GestureEvent
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcontrolKey : Boolean
Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist.
GestureEvent
 InheritedctrlKey : Boolean
Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist.
GestureEvent
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
 InheritedlocalX : Number
Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.
GestureEvent
 InheritedlocalY : 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
 Inheritedphase : 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
 InheritedshiftKey : Boolean
Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist.
GestureEvent
 InheritedstageX : Number
[schreibgeschützt] Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
GestureEvent
 InheritedstageY : Number
[schreibgeschützt] Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
GestureEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
  velocity : Number
Die Geschwindigkeit des Transformationsgestenereignisses in Pixel pro Sekunde.
TransformGestureEvent
Öffentliche Methoden
 MethodeDefiniert 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
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
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
 Inherited
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
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert 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
Eigenschaftendetails

offsetX

Eigenschaft
offsetX:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2, Flash Lite 4

Die horizontale Versetzung des Anzeigeobjekts seit dem vorherigen Gestenereignis.



Implementierung
    public function get offsetX():Number
    public function set offsetX(value:Number):void

offsetY

Eigenschaft 
offsetY:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2, Flash Lite 4

Die vertikale Versetzung des Anzeigeobjekts seit dem vorherigen Gestenereignis.



Implementierung
    public function get offsetY():Number
    public function set offsetY(value:Number):void

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 
scaleX:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2, Flash Lite 4

Die horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.



Implementierung
    public function get scaleX():Number
    public function set scaleX(value:Number):void

scaleY

Eigenschaft 
scaleY:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2, Flash Lite 4

Die vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.



Implementierung
    public function get scaleY():Number
    public function set scaleY(value:Number):void

velocity

Eigenschaft 
velocity:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 24, Flash Lite 4

Die Geschwindigkeit des Transformationsgestenereignisses in Pixel pro Sekunde.



Implementierung
    public function get velocity():Number
    public function set velocity(value:Number):void
Konstruktordetails

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.

Parameter
type: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

Methodendetails

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ückgabewerte
Event — 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 ... ]

Rückgabewerte
String — Ein String, der alle Eigenschaften des TransformGestureEvent-Objekts enthält.
Konstantendetails

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:

EigenschaftWert
altKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false
controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.
ctrlKeytrue 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.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
phaseDie aktuelle Phase im Ereignisablauf. Für Swipe-Ereignisse ist dieser Wert immer all entsprechend dem Wert GesturePhase.ALL, nachdem dieses Ereignis abgesetzt wurde.
localXDie 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.
localYDie 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.
scaleXDie horizontale Skalierung des Anzeigeobjekts. Für Richtungstippengesten beträgt dieser Wert 1.
scaleYDie vertikale Skalierung des Anzeigeobjekts. Für Richtungstippengesten beträgt dieser Wert 1.
rotationDer aktuelle Drehwinkel des Anzeigeobjekt entlang der z-Achse in Grad. Für Richtungstippengesten beträgt dieser Wert 0.
offsetXGibt die horizontale Richtung an: 1 für „nach rechts“ und -1 für „nach links“.
offsetYGibt die vertikale Richtung an: 1 für „nach unten“ und -1 für „nach oben“.
GeschwindigkeitGibt die Geschwindigkeit der Swipe-Geste in Pixel pro Sekunde an (nur AIR).
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
targetDie 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:

EigenschaftWert
altKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false
controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.
ctrlKeytrue 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.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
phaseDie aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse.
localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.
localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.
scaleXDie horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. Für Bildlaufgesten ist dieser Wert 1.
scaleYDie vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis. Für Bildlaufgesten ist dieser Wert 1.
rotationDer aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad. Für Bildlaufgesten ist dieser Wert 0.
offsetXDie horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.
offsetYDie vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.
GeschwindigkeitDie Geschwindigkeit des Gestenereignisses in Pixel pro Sekunde (nur AIR). Für Bildlaufgesten beträgt dieser Wert 0.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
targetDie 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 )

Die folgenden Beispiele zeigen die Ereignisverarbeitung für 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:

EigenschaftWert
altKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false
controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.
ctrlKeytrue 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.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
phaseDie aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse.
localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.
localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.
scaleXDie horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.
scaleYDie vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.
rotationDer aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad.
offsetXDie horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.
offsetYDie vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.
GeschwindigkeitDie Geschwindigkeit des Gestenereignisses in Pixel pro Sekunde (nur AIR). Für Drehgesten beträgt dieser Wert 0.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
targetDie 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 )

Die folgenden Beispiele zeigen die Ereignisverarbeitung für 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:

EigenschaftWert
altKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false
controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.
ctrlKeytrue 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.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
phaseDie aktuelle Phase im Ereignisablauf. Für Swipe-Ereignisse ist dieser Wert immer all entsprechend dem Wert GesturePhase.ALL, nachdem dieses Ereignis abgesetzt wurde.
localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.
localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.
scaleXDie horizontale Skalierung des Anzeigeobjekts. Für Swipe-Gesten ist dieser Wert 1
scaleYDie vertikale Skalierung des Anzeigeobjekts. Für Swipe-Gesten ist dieser Wert 1
rotationDer aktuelle Drehwinkel des Anzeigeobjekt entlang der z-Achse in Grad. Für Swipe-Gesten ist dieser Wert 0
offsetXGibt die horizontale Richtung an: 1 für „nach rechts“ und -1 für „nach links“.
offsetYGibt die vertikale Richtung an: 1 für „nach unten“ und -1 für „nach oben“.
GeschwindigkeitGibt die Geschwindigkeit der Swipe-Geste in Pixel pro Sekunde an (nur AIR). Für den Rest beträgt dieser Wert 0.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
targetDie 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 )

Die folgenden Beispiele zeigen die Ereignisverarbeitung für 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:

EigenschaftWert
altKeytrue, wenn die Alt-Taste aktiviert ist (Windows oder Linux).
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
commandKeytrue unter Mac OS, falls die Befehlstaste aktiviert ist; false, wenn sie deaktiviert ist. Unter Windows immer false
controlKeytrue, wenn die Strg- oder Ctrl-Taste aktiv ist; false, wenn sie nicht aktiv ist.
ctrlKeytrue 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.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
phaseDie aktuelle Phase im Ereignisablauf; ein Wert aus der GesturePhase-Klasse.
localXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.
localYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Anzeigeobjekt steht.
scaleXDie horizontale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.
scaleYDie vertikale Skalierung des Anzeigeobjekts seit dem vorherigen Gestenereignis.
rotationDer aktuelle Drehwinkel des Anzeigeobjekts um die z-Achse seit dem vorherigen Gestenereignis in Grad.
offsetXDie horizontale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.
offsetYDie vertikale Versetzung des Anzeigeobjekts von seiner Position beim vorherigen Gestenereignis.
GeschwindigkeitDie Geschwindigkeit des Gestenereignisses in Pixel pro Sekunde (nur AIR). Für Zoom-Gesten beträgt dieser Wert 0.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
targetDie 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 )

Die folgenden Beispiele zeigen die Ereignisverarbeitung für 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";
    }
}
TransformGestureEventExample.as

Die folgenden Beispiele zeigen die Ereignisverarbeitung für 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";
    }
}
TransformGestureExample2.as

Das folgende Beispiel zeigt, wie Transformationsgestenereignisse verarbeitet werden. In diesem Beispiel wird davon ausgegangen, dass Sie auf Ihrem lokalen System ein Bild namens „african_elephant.jpg“ im selben Verzeichnis wie die TransformGestureExample2-Klasse vorliegen haben. Das Beispiel stammt von Christian Cantrell und wird ausführlicher in seiner Kurzanleitung beschrieben: Multi-touch and gesture support on the Flash Platform.
 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;
        }
    }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.