TouchEvent  - AS3

Geeft aan of de Alt-toets actief (true) of inactief (false) is. Alleen ondersteund voor Windows- en Linux-besturingssystemen.

Geeft aan of de Command-toets is geactiveerd (alleen Macintosh).

Onder Mac OS is de waarde van de eigenschap commandKey dezelfde als die voor de eigenschap ctrlKey. Deze eigenschap is altijd false op Windows of Linux.

Hiermee wordt aangegeven of de Control-toets actief is op de Mac en of de Ctrl-toets actief is voor Windows of Linux.

In Windows of Linux wordt hiermee aangegeven of de Ctrl-toets actief (true) of inactief (false) is. Op de Macintosh wordt aangegeven of de Control- of Command-toets is geactiveerd.

Geeft aan of het eerste contactpunt aan muisgebeurtenissen is toegewezen.

Verwante API-elementen

Als de waarde true wordt geretourneerd, is de eigenschap relatedObject ingesteld op null vanwege redenen die te maken hebben met beveiligingssandboxen. Als de nominale waarde van relatedObject een verwijzing is naar een DisplayObject in een andere sandbox, wordt relatedObject ingesteld op null, tenzij er toestemming is de grens van deze sandbox in beide richtingen te overschrijden. Deze toestemming kan worden ingesteld door Security.allowDomain() aan te roepen vanuit een SWF-bestand of door vanaf de server een beleidsbestand beschikbaar te stellen voor een afbeeldingsbestand. In dat geval moet de eigenschap LoaderContext.checkPolicyFile worden ingesteld tijdens het laden van de afbeelding.

Verwante API-elementen

Meldt dat deze aanraakinvoersequentie door het besturingssysteem is geannuleerd.

Aanraakgebeurtenissen kunnen om verschillende redenen worden geannuleerd, bijvoorbeeld wanneer een door uw palm van de hand gegenereerde aanraking wordt afgewezen, omdat een penstylus in gebruik is. isTouchPointCanceled kan alleentrue zijn in een touchEnd-gebeurtenis.

De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.

De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.

Een waarde tussen 0,0 en 1,0 die de sterkte van het contact met het apparaat aangeeft. Als het apparaat het detecteren van de druk niet ondersteunt, is de waarde 1,0.

Een verwijzing naar een weergaveoverzichtobject dat betrekking heeft op de gebeurtenis. Wanneer bijvoorbeeld een gebeurtenis touchOut plaatsvindt, vertegenwoordigt relatedObject het weergaveoverzichtobject waar het aanwijsapparaat nu naar wijst. Deze eigenschap is van toepassing op de gebeurtenissen touchOut, touchOver, touchRollOut en touchRollOver.

De waarde van deze eigenschap kan in twee gevallen null zijn: als er geen verwant object is, of als er wel sprake is van een verwant object maar dit object zich in een beveiligingssandbox bevindt waartoe u geen toegang hebt. Gebruik de eigenschap isRelatedObjectInaccessible() om vast te stellen welke van deze redenen van toepassing is.

Verwante API-elementen

Geeft aan of de Shift-toets actief (true) of inactief (false) is.

Breedte van het contactgebied.

Hoogte van het contactgebied.

De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in algemene werkgebiedcoördinaten. Deze eigenschap wordt berekend wanneer de eigenschap localX is ingesteld.

De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in algemene werkgebiedcoördinaten. Deze eigenschap wordt berekend wanneer de eigenschap localY is ingesteld.

Meldt de tijd van de gebeurtenis, uitgedrukt in relatieve milliseconden.

De gerapporteerde tijden zijn relatief ten opzichte van de tijd waarop de toepassing is gestart. Voor gebeurtenissen die een sequentie van punten in de samplebuffer retourneren, weerspiegelt dit tijdstempel de tijd die is verstreken sinds het laatste sample in de buffer.

Verwante API-elementen

Meldt of de aanraking is gegenereerd door de primaire punt of door het gumuiteinde van een stylus.

Wanneer een aanraakgebeurtenis wordt gegenereerd door een vinger of een andere invoermethode zonder stylus of door een stylus waarvoor vaak voorkomende bewegingstracering niet wordt ondersteund, rapporteert deze eigenschap de waarde TouchEventIntent.UNKNOWN.

De klasse TouchEventIntent definieert constanten voor de mogelijke waarden van deze eigenschap, waaronder:

• TouchEventIntent.ERASER
• TouchEventIntent.PEN
• TouchEventIntent.UNKNOWN

Verwante API-elementen

Een uniek identificatienummer (als een int) dat aan het aanraakpunt is toegewezen.

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

Maakt een Event-object dat informatie bevat over aanraakgebeurtenissen. Gebeurtenisobjecten worden als parameters aan gebeurtenislisteners doorgegeven.

Maakt een kopie van het TouchEvent-object en stelt de waarde van elke eigenschap in zodat deze overeenkomt met die van het origineel.

Werkt het opgegeven ByteArray-object bij met de vaak voorkomende gegevenspunten voor een aanraakgebeurtenis met meerdere punten.

Het ByteArray-object waarnaar de buffer-parameter verwijst, wordt bijgewerkt met waarden voor de gegevenspunten tussen deze en de vorige aanraakgebeurtenis. Voor elk sample worden drie zwevende-kommawaarden toegevoegd: een x-coördinaat, een y-coördinaat en een drukwaarde. De positiewaarden, uitgedrukt in werkgebiedcoördinaten. De druk wordt gemeld als een waarde tussen 0 en 1. Samples worden bij een regelmatig tijdinterval opgenomen. De exacte frequentie is afhankelijk van de hardware en de stuurprogramma's van de hardware. De meeste samplefrequenties liggen rond de 133 Hz. Aanraakgebeurtenissen worden niet na een exact interval verzonden. De buffer voor vergelijkbare gebeurtenissen kan dus een verschillend aantal samples bevatten. Het laatste sample in de buffer heeft dezelfde gegevens als de eigenschappen stageX, stageY en pressure van dit aanraakgebeurtenisobject.

Een samplebuffer is opgenomen in de gebeurtenisobjecten die worden verzonden voor de gebeurtenissen proximityMove en touchMove.

Parameters

Verwante API-elementen

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

Meldt dat bij de opgegeven index op de hardwareknop is gedrukt.

Parameters

Retourneert een tekenreeks die alle eigenschappen van het TouchEvent-object bevat. De tekenreeks heeft de volgende indeling:

[TouchEvent type=waarde bubbles=waarde cancelable=waarde ... ]

Instrueert Flash Player of Adobe AIR te renderen nadat de verwerking van deze gebeurtenis is voltooid, als het weergaveoverzicht is gewijzigd.

Definieert de waarde van de eigenschap type van een PROXIMITY_BEGIN-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een PROXIMITY_END-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een PROXIMITY_MOVE-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een PROXIMITY_OUT-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een PROXIMITY_OVER-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een PROXIMITY_ROLL_OUT-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een PROXIMITY_ROLL_OVER-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een TOUCH_BEGIN-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een TOUCH_END-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een TOUCH_MOVE-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een TOUCH_OUT-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een TOUCH_OVER-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een TOUCH_ROLL_OUT-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een TOUCH_ROLL_OVER-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

Definieert de waarde van de eigenschap type van een TOUCH_TAP-aanraakgebeurtenisobject.

Het TouchEvent-object heeft de volgende eigenschappen:

Verwante API-elementen

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