TouchEvent  - AS3

Gibt an, ob die Alt-Taste aktiviert (true) oder deaktiviert (false) ist. Wird nur für Windows und Linux unterstützt.

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

Gibt an, ob unter Mac OS die Ctrl-Taste oder unter Windows oder Linux die Strg-Taste aktiviert ist.

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.

Gibt an, ob der erste Kontaktpunkt Mausereignissen zugeordnet ist.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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.

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

Die vertikale Koordinate, an der das Ereignis aufgetreten ist, das in Relation zum umgebenden Sprite-Objekt steht.

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.

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.

Verwandte API-Elemente

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

Breite des Kontaktbereichs.

Höhe des Kontaktbereichs.

Die horizontale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localX eingerichtet wird.

Die vertikale Koordinate, an der das Ereignis aufgetreten ist, in globalen Bühnenkoordinaten. Diese Eigenschaft wird berechnet, wenn die Eigenschaft localY eingerichtet wird.

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.

Verwandte API-Elemente

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

Verwandte API-Elemente

Eine eindeutige Kennung (wie eine Ganzzahl), die dem Kontaktpunkt zugeordnet ist.

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; 
}

Erstellt ein Ereignisobjekt, das Informationen über Berührungsereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Erstellt eine Kopie des TouchEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

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

Verwandte API-Elemente

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
        }
    }
}

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
        }
    }
}

Meldet, dass die Hardwaretaste beim angegebenen Index gedrückt wurde.

Parameter

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

Weist Flash Player oder Adobe AIR nach Abschluss der Verarbeitung dieses Ereignisses zur Wiedergabe an, wenn die Anzeigeliste geändert wurde.

Definiert den Wert der type-Eigenschaft eines PROXIMITY_BEGIN-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines PROXIMITY_END-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines PROXIMITY_MOVE-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines PROXIMITY_OUT-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines PROXIMITY_OVER-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines PROXIMITY_ROLL_OUT-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines PROXIMITY_ROLL_OVER-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines TOUCH_BEGIN-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines TOUCH_END-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines TOUCH_MOVE-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines TOUCH_OUT-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines TOUCH_OVER-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OUT-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines TOUCH_ROLL_OVER-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

Definiert den Wert der type-Eigenschaft eines TOUCH_TAP-Berührungsereignisobjekts.

Das abgesetzte TouchEvent-Objekt hat folgende Eigenschaften:

Verwandte API-Elemente

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);
}