| Paket | flash.events |
| Klasse | public class TouchEvent |
| Vererbung | TouchEvent  Event Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Wenn ein Benutzer mit einem Gerät mit Touchscreen, zum Beispiel bei einem Mobiltelefon oder Tablet, interagiert, setzt er normalerweise einen Finger oder Touchpen auf den Bildschirm und bewegt ihn. Mit der TouchEvent-Klasse können Sie Anwendungen entwickeln, die auf grundlegende Berührungsereignisse reagieren (zum Beispiel das einfache Tippen mit einem einzelnen Finger). Erstellen Sie Ereignis-Listener mit den Ereignistypen, die in dieser Klasse definiert sind. Für Benutzerinteraktionen mit mehreren Kontaktpunkten (zum Beispiel gleichzeitiges Bewegen mehrerer Finger über einen Touchscreen) verwenden Sie die verwandten GestureEvent-, PressAndTapGestureEvent- und TransformGestureEvent-Klassen. 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.
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.
In AIR 3 und neueren Versionen können Sie auf unterstützten Android-Geräten, die einen aktiven Eingabestift haben, Listener für Proximity-Ereignisse verwenden. Bei solchen Geräten stellen proximityMove- und touchMove-Ereignisobjekte ein Bytearray bereit, das Pfad- und Andrucksamples enthält, die seit dem letzten Verschieben-Ereignis gesammelt wurden. Sie können diese Muster verwenden, um den Pfad des Eingabestifts zwischen den Berührungsereignissen zu konstruieren. (Beachten Sie, das Hit-Testing für die Interaktion der Stifteingabe mit der Anzeigeliste nur am Ende eines Pfadsegments erfolgt.)
Verwandte API-Elemente
flash.ui.Multitouch
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Öffentliche Eigenschaften
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. | TouchEvent | ||
 | 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). | TouchEvent | ||
| 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. | TouchEvent | ||
| ctrlKey : Boolean
Gibt unter Windows oder Linux an, ob die Strg-Taste aktiviert (true) oder deaktiviert (false) ist. | TouchEvent | ||
| 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 | |
| isPrimaryTouchPoint : Boolean
Gibt an, ob der erste Kontaktpunkt Mausereignissen zugeordnet ist. | TouchEvent | ||
| isRelatedObjectInaccessible : Boolean
Falls „true“, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt. | TouchEvent | ||
| isTouchPointCanceled : Boolean
Meldet, dass diese Berührungseingabesequenz vom Betriebssystem abgebrochen wurde. | TouchEvent | ||
| localX : Number
Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite. | TouchEvent | ||
| localY : Number
Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht. | TouchEvent | ||
| pressure : Number
Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. | TouchEvent | ||
| relatedObject : InteractiveObject
Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. | TouchEvent | ||
| shiftKey : Boolean
Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist. | TouchEvent | ||
| sizeX : Number
Breite des Kontaktbereichs. | TouchEvent | ||
| sizeY : Number
Höhe des Kontaktbereichs. | TouchEvent | ||
| stageX : Number [schreibgeschützt]
Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. | TouchEvent | ||
| stageY : Number [schreibgeschützt]
Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. | TouchEvent | ||
| target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | |
| timestamp : Number
Meldet den Zeitpunkt des Ereignisses in relativen Millisekunden. | TouchEvent | ||
| touchIntent : String
Gibt an, ob die Berührung vom primären Ende oder vom Radiergummi eines Eingabestifts generiert wurde. | TouchEvent | ||
| touchPointID : int
Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. | TouchEvent | ||
| type : String [schreibgeschützt]
Der Ereignistyp. | Event | |
Öffentliche Methoden
| Methode | Definiert von | ||
|---|---|---|---|
TouchEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, touchPointID:int = 0, isPrimaryTouchPoint:Boolean = false, localX:Number = NaN, localY:Number = NaN, sizeX:Number = NaN, sizeY:Number = NaN, pressure:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, timestamp:Number = NaN, touchIntent:String, samples:ByteArray = null, isTouchPointCanceled:Boolean = false)
Erstellt ein Ereignisobjekt, das Informationen über Berührungsereignisse enthält. | TouchEvent | ||
[override]
Erstellt eine Kopie des TouchEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. | TouchEvent | ||
|
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | |
Aktualisiert das angegebene ByteArray-Objekt mit den Hochfrequenzdatenpunkten für ein Berührungsereignis mit mehreren Berührungspunkten. | TouchEvent | ||
|
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 | |
Meldet, dass die Hardwaretaste beim angegebenen Index gedrückt wurde. | TouchEvent | ||
|
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 TouchEvent-Objekts enthält. | TouchEvent | ||
Weist Flash Player oder Adobe AIR nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde. | TouchEvent | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
Öffentliche Konstanten
| Konstante | Definiert von | ||
|---|---|---|---|
| PROXIMITY_BEGIN : String = "proximityBegin" [statisch]
Definiert den Wert der type-Eigenschaft eines PROXIMITY_BEGIN-Berührungsereignisobjekts. | TouchEvent | ||
| PROXIMITY_END : String = "proximityEnd" [statisch]
Definiert den Wert der type-Eigenschaft eines PROXIMITY_END-Berührungsereignisobjekts. | TouchEvent | ||
| PROXIMITY_MOVE : String = "proximityMove" [statisch]
Definiert den Wert der type-Eigenschaft eines PROXIMITY_MOVE-Berührungsereignisobjekts. | TouchEvent | ||
| PROXIMITY_OUT : String = "proximityOut" [statisch]
Definiert den Wert der type-Eigenschaft eines PROXIMITY_OUT-Berührungsereignisobjekts. | TouchEvent | ||
| PROXIMITY_OVER : String = "proximityOver" [statisch]
Definiert den Wert der type-Eigenschaft eines PROXIMITY_OVER-Berührungsereignisobjekts. | TouchEvent | ||
| PROXIMITY_ROLL_OUT : String = "proximityRollOut" [statisch]
Definiert den Wert der type-Eigenschaft eines PROXIMITY_ROLL_OUT-Berührungsereignisobjekts. | TouchEvent | ||
| PROXIMITY_ROLL_OVER : String = "proximityRollOver" [statisch]
Definiert den Wert der type-Eigenschaft eines PROXIMITY_ROLL_OVER-Berührungsereignisobjekts. | TouchEvent | ||
| TOUCH_BEGIN : String = "touchBegin" [statisch]
Definiert den Wert der type-Eigenschaft eines TOUCH_BEGIN-Berührungsereignisobjekts. | TouchEvent | ||
| TOUCH_END : String = "touchEnd" [statisch]
Definiert den Wert der type-Eigenschaft eines TOUCH_END-Berührungsereignisobjekts. | TouchEvent | ||
| TOUCH_MOVE : String = "touchMove" [statisch]
Definiert den Wert der type-Eigenschaft eines TOUCH_MOVE-Berührungsereignisobjekts. | TouchEvent | ||
| TOUCH_OUT : String = "touchOut" [statisch]
Definiert den Wert der type-Eigenschaft eines TOUCH_OUT-Berührungsereignisobjekts. | TouchEvent | ||
| TOUCH_OVER : String = "touchOver" [statisch]
Definiert den Wert der type-Eigenschaft eines TOUCH_OVER-Berührungsereignisobjekts. | TouchEvent | ||
| TOUCH_ROLL_OUT : String = "touchRollOut" [statisch]
Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OUT-Berührungsereignisobjekts. | TouchEvent | ||
| TOUCH_ROLL_OVER : String = "touchRollOver" [statisch]
Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OVER-Berührungsereignisobjekts. | TouchEvent | ||
| TOUCH_TAP : String = "touchTap" [statisch]
Definiert den Wert der type-Eigenschaft eines TOUCH_TAP-Berührungsereignisobjekts. | TouchEvent | ||
Eigenschaftendetails
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):voidcommandKey | Eigenschaft |
commandKey:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, 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):voidisPrimaryTouchPoint | Eigenschaft |
isPrimaryTouchPoint:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Gibt an, ob der erste Kontaktpunkt Mausereignissen zugeordnet ist.
Implementierung
public function get isPrimaryTouchPoint():Boolean public function set isPrimaryTouchPoint(value:Boolean):voidVerwandte API-Elemente
isRelatedObjectInaccessible | Eigenschaft |
isRelatedObjectInaccessible:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Wenn true, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt. Ist der Nominalwert von relatedObject ein Verweis auf ein DisplayObject in einer anderen Sandbox, wird relatedObject auf null gesetzt, es sei denn, die Berechtigung gilt über die Sandboxgrenzen hinweg für beide Richtungen. Die Berechtigung wird eingerichtet, indem aus einer SWF-Datei Security.allowDomain() aufgerufen wird oder eine Richtliniendatei vom Server einer Bilddatei bereitgestellt und die LoaderContext.checkPolicyFile-Eigenschaft beim Laden des Bilds gesetzt wird.
Implementierung
public function get isRelatedObjectInaccessible():Boolean public function set isRelatedObjectInaccessible(value:Boolean):voidVerwandte API-Elemente
isTouchPointCanceled | Eigenschaft |
isTouchPointCanceled:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Meldet, dass diese Berührungseingabesequenz vom Betriebssystem abgebrochen wurde.
Berührungsereignisse können aus verschiedenen Gründen abgebrochen werden, zum Beispiel wenn eine von der Handfläche generierte Berührung abgelehnt wird, weil ein Eingabestift benutzt wird. isTouchPointCanceled kann nur true sein, wenn es sich um ein touchEnd-Ereignis handelt.
Implementierung
public function get isTouchPointCanceled():Boolean public function set isTouchPointCanceled(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):voidpressure | Eigenschaft |
pressure:Number| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.
Implementierung
public function get pressure():Number public function set pressure(value:Number):voidrelatedObject | Eigenschaft |
relatedObject:InteractiveObject| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Ein Verweis auf ein Anzeigelistenobjekt, das in Relation zum Ereignis steht. Wenn beispielsweise ein touchOut-Ereignis auftritt, stellt relatedObject das Anzeigelistenobjekt dar, auf das das Zeigegerät jetzt zeigt. Diese Eigenschaft gilt für die Ereignisse touchOut, touchOver, touchRollOut und touchRollOver.
Der Wert dieser Eigenschaft kann in zwei Fällen null sein: Wenn es kein verwandtes Objekt gibt oder wenn es eines gibt, dieses aber eine Sicherheitssandbox ist, auf die Sie keinen Zugriff haben. Verwenden Sie die isRelatedObjectInaccessible()-Eigenschaft, um festzustellen, welcher dieser Gründe zutrifft.
Implementierung
public function get relatedObject():InteractiveObject public function set relatedObject(value:InteractiveObject):voidVerwandte API-Elemente
shiftKey | Eigenschaft |
sizeX | Eigenschaft |
sizeY | 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():Number timestamp | Eigenschaft |
timestamp:Number| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Meldet den Zeitpunkt des Ereignisses in relativen Millisekunden.
Die Zeitangaben sind relativ zu der Zeit, als die Ausführung der Anwendung gestartet wurde. Bei Ereignissen, die eine Folge von Punkten im Samplespuffer zurückgegeben, gibt dieser Zeitstempel an, wie viel Zeit seit dem letzten Sample im Puffer vergangen ist.
Implementierung
public function get timestamp():Number public function set timestamp(value:Number):voidVerwandte API-Elemente
touchIntent | Eigenschaft |
touchIntent:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Gibt an, ob die Berührung vom primären Ende oder vom Radiergummi eines Eingabestifts generiert wurde.
Wenn ein Berührungsereignis von einem Finger oder mit einer anderen Methode, die keinen Eingabestift involviert, oder von einem Eingabestift, der die hochfrequente Bewegungsverfolgung nicht unterstützt, generiert wird, gibt diese Eigenschaft den Wert TouchEventIntent.UNKNOWN zurück.
Die TouchEventIntent-Klasse definiert Konstanten für die möglichen Werte dieser Eigenschaft. Dies sind:
- TouchEventIntent.ERASER
- TouchEventIntent.PEN
- TouchEventIntent.UNKNOWN
Implementierung
public function get touchIntent():String public function set touchIntent(value:String):voidVerwandte API-Elemente
touchPointID | Eigenschaft |
touchPointID:int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
Implementierung
public function get touchPointID():int public function set touchPointID(value:int):voidBeispiel ( Verwendung dieses Beispiels )
Im folgenden Beispiel wird eine
touchMoveID-Variable eingerichtet, um auf den richtigen touchPointID-Wert zu prüfen, bevor auf ein Berührungsverschiebungs-Ereignis reagiert wird. Andernfalls lösen auch andere Berührungseingaben diese Ereignisprozedur aus. Beachten Sie, dass sich die Listener für die Verschiebungs- und Endphasen auf der Bühne, nicht im Anzeigeobjekt befinden. Die Bühne wartet auf die Verschiebungs- oder Endphasen für den Fall, dass die Berührungsverschiebung des Benutzers über die Grenzen des Anzeigeobjekts hinausgeht.
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
var mySprite:Sprite = new Sprite();
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);
var myTextField:TextField = new TextField();
addChild(myTextField);
myTextField.width = 200;
myTextField.height = 20;
var touchMoveID:int = 0;
mySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
function onTouchBegin(event:TouchEvent) {
if(touchMoveID != 0) {
myTextField.text = "already moving. ignoring new touch";
return;
}
touchMoveID = event.touchPointID;
myTextField.text = "touch begin" + event.touchPointID;
stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
}
function onTouchMove(event:TouchEvent) {
if(event.touchPointID != touchMoveID) {
myTextField.text = "ignoring unrelated touch";
return;
}
mySprite.x = event.stageX;
mySprite.y = event.stageY;
myTextField.text = "touch move" + event.touchPointID;
}
function onTouchEnd(event:TouchEvent) {
if(event.touchPointID != touchMoveID) {
myTextField.text = "ignoring unrelated touch end";
return;
}
touchMoveID = 0;
stage.removeEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
stage.removeEventListener(TouchEvent.TOUCH_END, onTouchEnd);
myTextField.text = "touch end" + event.touchPointID;
}
Konstruktordetails
TouchEvent | () | Konstruktor |
public function TouchEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, touchPointID:int = 0, isPrimaryTouchPoint:Boolean = false, localX:Number = NaN, localY:Number = NaN, sizeX:Number = NaN, sizeY:Number = NaN, pressure:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, timestamp:Number = NaN, touchIntent:String, samples:ByteArray = null, isTouchPointCanceled:Boolean = false)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Erstellt ein Ereignisobjekt, das Informationen über Berührungsereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
Parametertype:String — Der Ereignistyp. Mögliche Werte sind: TouchEvent.PROXIMITY_BEGIN, TouchEvent.PROXIMITY_END, TouchEvent.PROXIMITY_MOVE, TouchEvent.PROXIMITY_OUT, TouchEvent.PROXIMITY_OVER, TouchEvent.PROXIMITY_ROLL_OUT, TouchEvent.PROXIMITY_ROLL_OVER, TouchEvent.TOUCH_BEGIN, TouchEvent.TOUCH_END, TouchEvent.TOUCH_MOVE, TouchEvent.TOUCH_OUT, TouchEvent.TOUCH_OVER, TouchEvent.TOUCH_ROLL_OUT, TouchEvent.TOUCH_ROLL_OVER und TouchEvent.TOUCH_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
touchPointID:int (default = 0) | |
isPrimaryTouchPoint:Boolean (default = false) | |
localX:Number (default = NaN) | |
localY:Number (default = NaN) | |
sizeX:Number (default = NaN) | |
sizeY:Number (default = NaN) | |
pressure:Number (default = NaN)0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0.
| |
relatedObject:InteractiveObject (default = null)touchOut-Ereignis auftritt, stellt relatedObject das Anzeigelistenobjekt dar, auf das das Zeigegerät jetzt zeigt.
| |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) | |
timestamp:Number (default = NaN) | |
touchIntent:String (default = NaN) | |
samples:ByteArray (default = null) | |
isTouchPointCanceled:Boolean (default = false)true, wenn das Berührungsereignis wegen eines abgelehnten Berührungstyps abgebrochen wurde.
|
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 TouchEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
RückgabewerteEvent — Ein neues TouchEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
|
getSamples | () | Methode |
public function getSamples(buffer:ByteArray, append:Boolean = false):uint| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Aktualisiert das angegebene ByteArray-Objekt mit den Hochfrequenzdatenpunkten für ein Berührungsereignis mit mehreren Berührungspunkten.
Das ByteArray-Objekt, auf das der buffer-Parameter verweist, wird mit Werten für die Zwischendatenpunkte zwischen diesem und dem vorherigen Touch-Ereignis aktualisiert. Für jedes Sample werden Gleitkommawerte hinzugefügt: eine x-Koordinate, eine y-Koordinate und ein Andruckwert. Die Positionswerte werden in Bühnenkoordinaten angegeben. Der Andruck wird als Wert zwischen 0 und 1 angegeben. Samples werden in regelmäßigen Zeitabständen genommen. Die genaue Häufigkeit richtet sich nach der Gerätehardware und den Hardwaretreibern. Typischen Samplefrequenzen liegen um 133 Hz. Beachten Sie, dass Berührungsereignisse nicht in genauen Intervallen abgesetzt werden. Deshalb kann der Puffer für ähnliche Ereignisse unterschiedlich viele Samples enthalten. Das letzte Sample im Puffer hat dieselben Daten wie die stageX-, stageY- und pressure-Eigenschaften dieses Berührungsereignisobjekts.
Ein Samplepuffer ist in den Ereignisobjekten enthalten, die für proximityMove- und touchMove-Ereignisse abgesetzt werden.
Parameter
buffer:ByteArray — das ByteArray-Objekt, das die Sampledaten aufnimmt.
| |
append:Boolean (default = false)true werden die Samples dem buffer-Bytearray hinzugefügt, beginnend bei der aktuellen position-Eigenschaft des Arrays. Bei der Einstellung false (Standardeinstellung) werden die vorhandenen Daten im Pufferobjekt verworfen, bevor die Samples hinzugefügt werden.
|
uint — uint die Anzahl der Samples, die dem Puffer hinzugefügt werden. Jedes Sample besteht aus drei Gleitkommazahlen.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
Das folgende Beispiel zeigt, wie die Sampledaten von einem touchMove- oder proximityMove-Ereignis abgerufen werden:
function touchMoveHandler( event:TouchEvent ):void
{
if( (event.type == TouchEvent.TOUCH_MOVE ||
event.type == TouchEvent.PROXIMITY_MOVE) &&
event.touchEventIntent != TouchEventIntent.UNKNOWN )
{
var samples:ByteArray = new ByteArray();
event.getSamples( samples, true );
samples.position = 0; // rewind to beginning of array before reading
var xCoord:Number, yCoord:Number, pressure:Number;
while( samples.bytesAvailable > 0 )
{
xCoord = samples.readFloat();
yCoord = samples.readFloat();
pressure = samples.readFloat();
//do something with the sample data
}
}
}
Das folgende Beispiel zeigt, wie die Sampledaten von einem touchMove- oder proximityMove-Ereignis abgerufen werden. In diesem Beispiel werden die Samples an ein vorhandenes Bytearray angehängt:
var samples:ByteArray = new ByteArray();
function touchMoveHandler( event:TouchEvent ):void
{
if( (event.type == TouchEvent.TOUCH_MOVE ||
event.type == TouchEvent.PROXIMITY_MOVE) &&
event.touchEventIntent != TouchEventIntent.UNKNOWN )
{
var sampleCount:uint = event.getSamples( samples, true );
var xCoord:Number, yCoord:Number, pressure:Number;
for( var i:int; i < sampleCount; i++ )
{
xCoord = samples.readFloat();
yCoord = samples.readFloat();
pressure = samples.readFloat();
//do something with the sample data
}
}
}
isToolButtonDown | () | Methode |
public function isToolButtonDown(index:int):Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Meldet, dass die Hardwaretaste beim angegebenen Index gedrückt wurde.
Parameter
index:int — der nullbasierte Index der Tasten, die von einem Eingabegerät des Typs Eingabestift unterstützt werden.
|
Boolean |
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 TouchEvent-Objekts enthält. Der String liegt im folgenden Format vor:
[TouchEvent type=Wert bubbles=Wert cancelable=Wert ... ]
String — Ein String, der alle Eigenschaften des TouchEvent-Objekts enthält.
|
updateAfterEvent | () | Methode |
public function updateAfterEvent():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Weist Flash Player oder Adobe AIR nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde.
Konstantendetails
PROXIMITY_BEGIN | Konstante |
public static const PROXIMITY_BEGIN:String = "proximityBegin"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Definiert den Wert der type-Eigenschaft eines PROXIMITY_BEGIN-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
timestamp | (Nur AIR) Der Zeitstempel des Ereignisses in Millisekunden in Relation zum Start der Anwendung. |
touchIntent | (Nur AIR) Ein Wert aus der TouchEventIntent-Klasse. |
isTouchPointCanceled | (Nur AIR) true, wenn das Berührungsereignis wegen der Berührungsablehnungslogik des Geräts abgebrochen wird. |
Verwandte API-Elemente
PROXIMITY_END | Konstante |
public static const PROXIMITY_END:String = "proximityEnd"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Definiert den Wert der type-Eigenschaft eines PROXIMITY_END-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
timestamp | (Nur AIR) Der Zeitstempel des Ereignisses in Millisekunden in Relation zum Start der Anwendung. |
touchIntent | (Nur AIR) Ein Wert aus der TouchEventIntent-Klasse. |
isTouchPointCanceled | (Nur AIR) true, wenn das Berührungsereignis wegen der Berührungsablehnungslogik des Geräts abgebrochen wird. |
Verwandte API-Elemente
PROXIMITY_MOVE | Konstante |
public static const PROXIMITY_MOVE:String = "proximityMove"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Definiert den Wert der type-Eigenschaft eines PROXIMITY_MOVE-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
timestamp | (Nur AIR) Der Zeitstempel des Ereignisses in Millisekunden in Relation zum Start der Anwendung. |
touchIntent | (Nur AIR) Ein Wert aus der TouchEventIntent-Klasse. |
isTouchPointCanceled | (Nur AIR) true, wenn das Berührungsereignis wegen der Berührungsablehnungslogik des Geräts abgebrochen wird. |
Verwandte API-Elemente
PROXIMITY_OUT | Konstante |
public static const PROXIMITY_OUT:String = "proximityOut"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Definiert den Wert der type-Eigenschaft eines PROXIMITY_OUT-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
timestamp | (Nur AIR) Der Zeitstempel des Ereignisses in Millisekunden in Relation zum Start der Anwendung. |
touchIntent | (Nur AIR) Ein Wert aus der TouchEventIntent-Klasse. |
isTouchPointCanceled | (Nur AIR) true, wenn das Berührungsereignis wegen der Berührungsablehnungslogik des Geräts abgebrochen wird. |
Verwandte API-Elemente
PROXIMITY_OVER | Konstante |
public static const PROXIMITY_OVER:String = "proximityOver"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Definiert den Wert der type-Eigenschaft eines PROXIMITY_OVER-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
timestamp | (Nur AIR) Der Zeitstempel des Ereignisses in Millisekunden in Relation zum Start der Anwendung. |
touchIntent | (Nur AIR) Ein Wert aus der TouchEventIntent-Klasse. |
isTouchPointCanceled | (Nur AIR) true, wenn das Berührungsereignis wegen der Berührungsablehnungslogik des Geräts abgebrochen wird. |
Verwandte API-Elemente
PROXIMITY_ROLL_OUT | Konstante |
public static const PROXIMITY_ROLL_OUT:String = "proximityRollOut"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Definiert den Wert der type-Eigenschaft eines PROXIMITY_ROLL_OUT-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
timestamp | (Nur AIR) Der Zeitstempel des Ereignisses in Millisekunden in Relation zum Start der Anwendung. |
touchIntent | (Nur AIR) Ein Wert aus der TouchEventIntent-Klasse. |
isTouchPointCanceled | (Nur AIR) true, wenn das Berührungsereignis wegen der Berührungsablehnungslogik des Geräts abgebrochen wird. |
Verwandte API-Elemente
PROXIMITY_ROLL_OVER | Konstante |
public static const PROXIMITY_ROLL_OVER:String = "proximityRollOver"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3 |
Definiert den Wert der type-Eigenschaft eines PROXIMITY_ROLL_OVER-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
timestamp | (Nur AIR) Der Zeitstempel des Ereignisses in Millisekunden in Relation zum Start der Anwendung. |
touchIntent | (Nur AIR) Ein Wert aus der TouchEventIntent-Klasse. |
isTouchPointCanceled | (Nur AIR) true, wenn das Berührungsereignis wegen der Berührungsablehnungslogik des Geräts abgebrochen wird. |
Verwandte API-Elemente
TOUCH_BEGIN | Konstante |
public static const TOUCH_BEGIN:String = "touchBegin"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines TOUCH_BEGIN-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
Verwandte API-Elemente
TOUCH_END | Konstante |
public static const TOUCH_END:String = "touchEnd"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines TOUCH_END-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
Verwandte API-Elemente
TOUCH_MOVE | Konstante |
public static const TOUCH_MOVE:String = "touchMove"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines TOUCH_MOVE-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
Verwandte API-Elemente
TOUCH_OUT | Konstante |
public static const TOUCH_OUT:String = "touchOut"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines TOUCH_OUT-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
Verwandte API-Elemente
TOUCH_OVER | Konstante |
public static const TOUCH_OVER:String = "touchOver"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines TOUCH_OVER-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
Verwandte API-Elemente
TOUCH_ROLL_OUT | Konstante |
public static const TOUCH_ROLL_OUT:String = "touchRollOut"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OUT-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
Verwandte API-Elemente
TOUCH_ROLL_OVER | Konstante |
public static const TOUCH_ROLL_OVER:String = "touchRollOver"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OVER-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
Verwandte API-Elemente
TOUCH_TAP | Konstante |
public static const TOUCH_TAP:String = "touchTap"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definiert den Wert der type-Eigenschaft eines TOUCH_TAP-Berührungsereignisobjekts.
Das abgesetzte TouchEvent-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. |
eventPhase | Die aktuelle Phase im Ereignisablauf. |
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. |
pressure | Ein Wert zwischen 0.0 und 1.0, der die Stärke des Kontakts mit dem Gerät angibt. Wenn das Gerät die Druck-Erkennung nicht unterstützt, ist dieser Wert1.0. |
relatedObject | Ein Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
sizeX | Breite des Kontaktbereichs. |
sizeY | Höhe des Kontaktbereichs. |
stageX | Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
stageY | Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. |
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. |
touchPointID | Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist. |
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
Im folgenden Beispiel wird eine Meldung angezeigt, wenn bei einem Touchscreen auf das in mySprite gezeichnete Quadrat getippt wird:
Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;
var mySprite:Sprite = new Sprite();
var myTextField:TextField = new TextField();
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);
mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);
function taphandler(e:TouchEvent): void {
myTextField.text = "I've been tapped";
myTextField.y = 50;
addChild(myTextField);
}
Beispiele Verwendung dieses Beispiels
TouchEventExample.as
Das folgende Beispiel zeigt die Ereignisverarbeitung für
TOUCH_BEGIN-, TOUCH_MOVE- und TOUCH_END-Ereignisse. Während sich der Kontaktpunkt über den Bildschirm bewegt (onTouchMove), wird die x-Koordinate in Relation zur Bühne in der Ausgabe verfolgt. Für den Sprite.startTouchDrag-Parameter in der onTouchBegin-Funktion ist der Wert für touchPointID der Wert, der dem Ereignisobjekt zugewiesen wurde. Der bounds-Parameter ist das Rechteck, das die Grenzen des übergeordneten Anzeigeobjekts definiert (bg ist ein Anzeigeobjekt, das MySprite enthält).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
TouchExample2.as
Das folgende Beispiel zeigt, wie Berührungsereignisse und Berührungsereignisphasen sowie die
Multitouch.maxTouchPoints- und die touchPointID-Eigenschaften des Berührungsobjekts verarbeitet werden. 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.Sprite;
import flash.events.TouchEvent;
import flash.text.AntiAliasType;
import flash.text.TextField;
import flash.text.TextFormat;
import flash.ui.Multitouch;
import flash.ui.MultitouchInputMode;
[SWF(width=320, height=460, frameRate=24, backgroundColor=0xEB7F00)]
public class TouchExample2 extends Sprite
{
private var dots:Object;
private var labels:Object;
private var labelFormat:TextFormat;
private var dotCount:uint;
private var dotsLeft:TextField;
private static const LABEL_SPACING:uint = 15;
public function TouchExample2()
{
super();
this.labelFormat = new TextFormat();
labelFormat.color = 0xACF0F2;
labelFormat.font = "Helvetica";
labelFormat.size = 11;
this.dotCount = 0;
this.dotsLeft = new TextField();
this.dotsLeft.width = 300;
this.dotsLeft.defaultTextFormat = this.labelFormat;
this.dotsLeft.x = 3;
this.dotsLeft.y = 0;
this.stage.addChild(this.dotsLeft);
this.updateDotsLeft();
this.dots = new Object();
this.labels = new Object();
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
this.stage.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
this.stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
this.stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
}
private function onTouchBegin(e:TouchEvent):void
{
if (this.dotCount == Multitouch.maxTouchPoints) return;
var dot:Sprite = this.getCircle();
dot.x = e.stageX;
dot.y = e.stageY;
this.stage.addChild(dot);
dot.startTouchDrag(e.touchPointID, true);
this.dots[e.touchPointID] = dot;
++this.dotCount;
var label:TextField = this.getLabel(e.stageX + ", " + e.stageY);
label.x = 3;
label.y = this.dotCount * LABEL_SPACING;
this.stage.addChild(label);
this.labels[e.touchPointID] = label;
this.updateDotsLeft();
}
private function onTouchMove(e:TouchEvent):void
{
var label:TextField = this.labels[e.touchPointID];
label.text = (e.stageX + ", " + e.stageY);
}
private function onTouchEnd(e:TouchEvent):void
{
var dot:Sprite = this.dots[e.touchPointID];
var label:TextField = this.labels[e.touchPointID];
this.stage.removeChild(dot);
this.stage.removeChild(label);
delete this.dots[e.touchPointID];
delete this.labels[e.touchPointID];
--this.dotCount;
this.updateDotsLeft();
}
private function getCircle(circumference:uint = 40):Sprite
{
var circle:Sprite = new Sprite();
circle.graphics.beginFill(0x1695A3);
circle.graphics.drawCircle(0, 0, circumference);
return circle;
}
private function getLabel(initialText:String):TextField
{
var label:TextField = new TextField();
label.defaultTextFormat = this.labelFormat;
label.selectable = false;
label.antiAliasType = AntiAliasType.ADVANCED;
label.text = initialText;
return label;
}
private function updateDotsLeft():void
{
this.dotsLeft.text = "Touches Remaining: " + (Multitouch.maxTouchPoints - this.dotCount);
}
}
}
Tue Jun 12 2018, 10:04 AM Z