TouchEvent  - AS3

Określa, czy klawisz Alt jest aktywny (true), czy nieaktywny (false). Obsługiwany tylko w systemach operacyjnych Windows i Linux.

Określa, czy klawisz Command jest aktywny (tylko w systemach Mac).

W systemie Mac OS wartość właściwości commandKey jest taka sama, jak wartość właściwości ctrlKey. Ta właściwość ma zawsze wartość false w systemach Windows i Linux.

Określa, czy klawisz Control jest aktywny w systemie Mac lub czy klawisz Ctrl jest aktywny w systemie Windows lub Linux.

W systemach Windows lub Linux określa, czy klawisz Ctrl jest aktywny (true), czy nieaktywny (false). W systemie Macintosh określa, czy aktywny jest klawisz Control albo Command.

Wskazuje, czy pierwszy punkt kontaktu jest odwzorowywany na zdarzenia myszy.

Powiązane elementy interfejsu API

Jeśli wartość to true, właściwość relatedObject zostanie ustawiona na wartość null z przyczyn związanych z bezpiecznymi obszarami izolowanymi. Jeśli nominalną wartością właściwości relatedObject jest odwołanie do obiektu DisplayObject w innym obszarze izolowanym, właściwość relatedObject zostanie ustawiona na wartość null, chyba że ustanowiono uprawnienia w obu kierunkach przez granice obszaru izolowanego. Uprawnienie ustanawiane jest przez wywołanie metody Security.allowDomain() z pliku SWF lub przez dostarczenie pliku reguł z serwera pliku obrazu i ustawianie właściwości LoaderContext.checkPolicyFile podczas ładowania obrazu.

Powiązane elementy interfejsu API

Zgłasza, że system operacyjny anulował tę sekwencję dotknięć.

Zdarzenia dotyku mogą być anulowane z różnych powodów, na przykład wtedy, gdy dotknięcie dłonią zostało odrzucone, ponieważ jest używane pióro. Właściwość isTouchPointCanceled może mieć tylko wartość true w zdarzeniu touchEnd.

Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki).

Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki).

Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0.

Odwołanie do listy powiązanej ze zdarzeniem. Na przykład gdy zajdzie zdarzenie touchOut, właściwość relatedObject reprezentuje obiekt listy wyświetlania wskazywany teraz przez urządzenie wskazujące. Właściwość ma zastosowanie do zdarzeń touchOut, touchOver, touchRollOut i touchRollOver.

Wartość tej właściwości może mieć wartość null w dwóch przypadkach: jeśli nie istnieje powiązany obiekt lub istnieje powiązany obiekt, ale obiekt ten znajduje się w bezpiecznym obszarze izolowanym, do którego programista nie ma dostępu. Aby wskazać, który z tych powodów znajduje zastosowanie, należy użyć właściwości isRelatedObjectInaccessible().

Powiązane elementy interfejsu API

Określa, czy klawisz Shift jest aktywny (true), czy nieaktywny (false).

Szerokość obszaru kontaktu.

Wysokość obszaru kontaktu.

Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). Ta właściwość jest obliczana po ustawieniu wartości właściwości localX.

Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). Ta właściwość jest obliczana po ustawieniu wartości właściwości localY.

Zgłasza względny czas zdarzenia w milisekundach.

Wartości czasu są wskazywane względem momentu uruchomienia aplikacji. W przypadku zdarzeń, które zwracają sekwencję punktów w buforze próbek, ten znacznik czasowy wskazuje czas, jaki upłynął, dla ostatniej próbki w buforze.

Powiązane elementy interfejsu API

Wskazuje, czy dotknięcie zostało wygenerowane przez cienką, czy szeroką końcówkę pisaka.

Jeśli zdarzenie dotyku zostało wygenerowane za pomocą palca lub innej metody wprowadzania bez użycia pisaka albo zostało wygenerowane za pomocą pisaka nieobsługującego śledzenia ruchu z wysoką częstotliwością, ta właściwość ma wartość TouchEventIntent.UNKNOWN.

Klasa TouchEventIntent definiuje stałe określające możliwe wartości tej właściwości, które obejmują:

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

Powiązane elementy interfejsu API

Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku.

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

Tworzy obiekt Event, który zawiera informacje o zdarzeniach dotyku. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.

Tworzy kopię obiektu TouchEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.

Aktualizuje określony obiekt ByteArray przy użyciu punktów danych rejestrowanych z wysoką częstotliwością w przypadku zdarzenia dotyku wielopunktowego.

Obiekt ByteArray, do którego odnosi się parametr buffer, jest aktualizowany przy użyciu wartości pośrednich punktów danych między tym i poprzednim zdarzeniem dotyku. Dla każdej próbki są dodawane trzy wartości zmiennoprzecinkowe: współrzędna x, współrzędna y oraz wartość nacisku. Wartości położenia są określane we współrzędnych stołu montażowego. Nacisk jest określany jako wartość z przedziału od 0 do 1. Próbki są rejestrowane w regularnych odstępach czasu. Dokładna częstotliwość zależy od urządzenia i sterowników sprzętu. W typowych przypadkach częstotliwość próbkowania wynosi około 133 Hz. Zdarzenia dotyku nie są wywoływane w precyzyjnych odstępach czasu. Dlatego w przypadku podobnych zdarzeń bufor może zawierać różną liczbę próbek. Ostatnia próbka w buforze zawiera takie same dane jak właściwości stageX, stageY i pressure tego obiektu zdarzenia dotyku.

Bufor próbek jest dołączany do obiektów zdarzeń wywoływanych w przypadku zdarzeń proximityMove i touchMove.

Parametry

Powiązane elementy interfejsu API

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

Zgłasza naciśnięcie przycisku sprzętowego z określonym indeksem.

Parametry

Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu TouchEvent. Format ciągu znaków jest następujący:

[TouchEvent type=wartość bubbles=wartość cancelable=wartość ... ]

Powoduje, że po zakończeniu przetwarzania tego zdarzenia program Flash Player lub środowisko wykonawcze Adobe AIR renderuje obraz, jeśli lista wyświetlania została zmodyfikowana.

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_BEGIN.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_END.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_MOVE.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_OUT.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_OVER.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_ROLL_OUT.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_ROLL_OVER.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_BEGIN.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_END.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_MOVE.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_OUT.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_OVER.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_ROLL_OUT.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_ROLL_OVER.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_TAP.

Wywołany obiekt TouchEvent ma następujące właściwości:

Powiązane elementy interfejsu API

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