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 

TouchEvent  - AS3

Paketflash.events
Klassepublic class TouchEvent
VererbungTouchEvent Inheritance Event Inheritance Object

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

Mit der TouchEvent-Klasse können Sie Ereignisse auf Geräten verarbeiten, die den Benutzerkontakt mit dem Gerät erkennen (z. B. ein Finger auf einem Touchscreen).

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.)

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  altKey : Boolean
Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist.
TouchEvent
 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
  commandKey : Boolean
Gibt an, ob die Befehlstaste aktiviert ist (nur Mac).
TouchEvent
 Inheritedconstructor : 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
 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
  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
 Inheritedtarget : 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
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert 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
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
  
    getSamples(buffer:ByteArray, append:Boolean = false):uint
Aktualisiert das angegebene ByteArray-Objekt mit den Hochfrequenzdatenpunkten für ein Berührungsereignis mit mehreren Berührungspunkten.
TouchEvent
 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
  
Meldet, dass die Hardwaretaste beim angegebenen Index gedrückt wurde.
TouchEvent
 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 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
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert 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):void

commandKey

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):void

controlKey

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):void

ctrlKey

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):void

isPrimaryTouchPoint

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):void

Verwandte 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):void

Verwandte 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):void

localX

Eigenschaft 
localX:Number

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

Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.



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

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):void

pressure

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):void

relatedObject

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):void

Verwandte API-Elemente

shiftKey

Eigenschaft 
shiftKey:Boolean

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

Gibt an, ob die Umschalttaste aktiviert (true) oder deaktiviert (false) ist.



Implementierung
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void

sizeX

Eigenschaft 
sizeX:Number

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

Breite des Kontaktbereichs.



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

sizeY

Eigenschaft 
sizeY:Number

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

Höhe des Kontaktbereichs.



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

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():Number

stageY

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):void

Verwandte 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):void

Verwandte 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):void

Beispiel  ( 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.

Parameter
type: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) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt.
 
cancelable:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann.
 
touchPointID:int (default = 0) — Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.
 
isPrimaryTouchPoint:Boolean (default = false) — Gibt an, ob der erste Kontaktpunkt Mausereignissen zugeordnet ist.
 
localX:Number (default = NaN) — Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in Relation zum umgebenden Sprite.
 
localY:Number (default = NaN) — Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.
 
sizeX:Number (default = NaN) — Breite des Kontaktbereichs.
 
sizeY:Number (default = NaN) — Höhe des Kontaktbereichs.
 
pressure:Number (default = NaN) — 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:InteractiveObject (default = null) — Die andere InteractiveObject-Instanz, die von dem Ereignis betroffen ist. Wenn beispielsweise ein touchOut-Ereignis auftritt, stellt relatedObject das Anzeigelistenobjekt dar, auf das das Zeigegerät jetzt zeigt.
 
ctrlKey: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.
 
altKey:Boolean (default = false) — Gibt an, ob die Alt-Taste aktiviert ist (nur Windows oder Linux).
 
shiftKey:Boolean (default = false) — Gibt an, ob der Umschalttasten-Modifizierer aktiviert ist.
 
commandKey: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.
 
controlKey:Boolean (default = false) — (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.
 
timestamp:Number (default = NaN) — (Nur AIR) Der Zeitstempel des Ereignisses in Millisekunden in Relation zum Start der Anwendung.
 
touchIntent:String (default = NaN) — (Nur AIR) Ein Wert aus der TouchEventIntent-Klasse.
 
samples:ByteArray (default = null) — (Nur AIR) Ein ByteArray-Objekt, das Positions- und Andruckwerte für jedes Zwischenmuster enthält, das seit dem letzten Touch- oder Proximity-Ereignis in einer Sequenz abgelesen wurde.
 
isTouchPointCanceled:Boolean (default = false) — (Nur AIR) 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ückgabewerte
Event — 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) — bei der Einstellung 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.

Rückgabewerte
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.

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

Rückgabewerte
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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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:

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.
eventPhaseDie aktuelle Phase im Ereignisablauf.
isRelatedObjectInaccessibletrue, wenn die relatedObject-Eigenschaft aufgrund von Sicherheitssandboxregeln den Wert null hat.
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.
pressureEin 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.
relatedObjectEin Verweis auf ein Anzeigelistenobjekt, das mit diesem Ereignis verwandt ist.
shiftKeytrue, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist.
sizeXBreite des Kontaktbereichs.
sizeYHöhe des Kontaktbereichs.
stageXDie horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
stageYDie vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten.
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.
touchPointIDEine 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);
}
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);
        }
    }
}




[ 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.