| Paket | flash.events |
| Klasse | public class GestureEvent |
| Vererbung | GestureEvent  Event Object |
| Unterklassen | PressAndTapGestureEvent, TransformGestureEvent |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Verwandte API-Elemente
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| 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 | ||
| phase : String
Ein Wert aus der GesturePhase-Klasse, die den Fortschritt der Berührungsgeste angibt. | GestureEvent | ||
| 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 | |
| Methode | Definiert von | ||
|---|---|---|---|
GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)
Erstellt ein Event-Objekt mit Informationen zu Mehrfinger-Ereignissen (zum Beispiel das gleichzeitige Drücken von zwei Fingern auf einen Touchscreen). | GestureEvent | ||
[override]
Erstellt eine Kopie des GestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. | GestureEvent | ||
|
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 GestureEvent-Objekts enthält. | GestureEvent | ||
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_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [statisch]
Definiert den Wert der type-Eigenschaft eines GESTURE_TWO_FINGER_TAP-Gestenereignisobjekts. | GestureEvent | ||
altKey | Eigenschaft |
altKey:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist. Wird nur für Windows und Linux unterstützt.
Implementierung
public function get altKey():Boolean public function set altKey(value:Boolean):void commandKey | Eigenschaft |
commandKey:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2 |
Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).
Unter Mac OS ist der Wert der commandKey-Eigenschaft identisch mit dem Wert der ctrlKey-Eigenschaft. Diese Eigenschaft ist unter Windows oder Linux immer „false“.
Implementierung
public function get commandKey():Boolean public function set commandKey(value:Boolean):voidcontrolKey | Eigenschaft |
controlKey:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist.
Implementierung
public function get controlKey():Boolean public function set controlKey(value:Boolean):voidctrlKey | Eigenschaft |
ctrlKey:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist. Unter Mac wird damit angezeigt, ob die Ctrl-Taste oder die Befehlstaste aktiviert ist.
Implementierung
public function get ctrlKey():Boolean public function set ctrlKey(value:Boolean):voidlocalX | Eigenschaft |
localY | Eigenschaft |
localY:Number| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.
Implementierung
public function get localY():Number public function set localY(value:Number):voidphase | Eigenschaft |
phase:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Ein Wert aus der GesturePhase-Klasse, die den Fortschritt der Berührungsgeste angibt. Bei den meisten Gesten ist der Wert begin, update oder end. Bei Swipe- und Zwei-Finger-Tipp-Ereignisse ist der Wert für die Phase immer all, nachdem das Ereignis abgesetzt wurde. Verwenden Sie diesen Wert, um festzustellen, wenn eine Ereignisprozedur auf eine komplexe Benutzerinteraktion reagiert oder unterschiedlich je nach der aktuellen Phase einer Multitouch-Geste reagiert (zum Beispiel beim Erweitern, Bewegen und Ablegen, wenn ein Benutzer ein visuelles Objekt berührt und über den Bildschirm zieht).
Implementierung
public function get phase():String public function set phase(value:String):voidVerwandte API-Elemente
shiftKey | Eigenschaft |
stageX | Eigenschaft |
stageX:Number [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localX eingerichtet wird.
Implementierung
public function get stageX():NumberstageY | Eigenschaft |
stageY:Number [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localY eingerichtet wird.
Implementierung
public function get stageY():NumberGestureEvent | () | Konstruktor |
public function GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Erstellt ein Event-Objekt mit Informationen zu Mehrfinger-Ereignissen (zum Beispiel das gleichzeitige Drücken von zwei Fingern auf einen Touchscreen). Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
Parametertype:String — Der Ereignistyp. Der unterstützte Wert lautet: GestureEvent.GESTURE_TWO_FINGER_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
phase:String (default = null) | |
localX:Number (default = 0) | |
localY:Number (default = 0) | |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) |
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 GestureEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
RückgabewerteEvent — Ein neues GestureEvent-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 GestureEvent-Objekts enthält. Der String liegt im folgenden Format vor:
[GestureEvent type=Wert bubbles=Wert cancelable=Wert ... ]
String — Ein String, der alle Eigenschaften des GestureEvent-Objekts enthält.
|
updateAfterEvent | () | Methode |
public function updateAfterEvent():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Aktualisiert die Anzeige der Flash-Laufzeitumgebung nach der Verarbeitung des Gestenereignisses, für den Fall, dass die Anzeigeliste von der Ereignisprozedur geändert wurde.
GESTURE_TWO_FINGER_TAP | Konstante |
public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines GESTURE_TWO_FINGER_TAP-Gestenereignisobjekts.
Das abgesetzte GestureEvent-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 | (Nur AIR) 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 Zwei-Finger-Tipp-Ereignisse ist dieser Wert immer all entsprechend dem Wert GesturePhase.ALL, nachdem dieses Ereignis abgesetzt wurde. |
isRelatedObjectInaccessible | true, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat. |
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. |
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_TWO_FINGER_TAP-Ereignis. Während der Benutzer eine Tippgeste mit zwei Fingern ausführt, dreht sich mySprite und myTextField wird mit der Phase all ausgefüllt, was die einzige Phase für Tippereignisse mit zwei Fingern ist. Andere Gesten aus der TransformGestureEvent-Klasse unterstützen Anfangs-, Update- und Endphasen.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onTwoFingerTap(evt:GestureEvent):void {
evt.target.rotation -= 45;
myTextField.text = evt.phase; //"all"
}
Tue Jun 12 2018, 10:04 AM Z