| Pakiet | flash.events |
| Klasa | public class TouchEvent |
| Dziedziczenie | TouchEvent  Event Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Gdy użytkownik wchodzi w interakcje z urządzeniem, takim jak telefon komórkowy lub tablet z ekranem dotykowym, użytkownik zwykle dotyka ekranu palcem lub urządzeniem wskazującym. Korzystając z klasy TouchEvent można tworzyć aplikacje, które będą reagowały na proste zdarzenia dotyku (takie jak puknięcie palcem). Detektory zdarzeń można tworzyć za pomocą typów zdarzeń zdefiniowanych w tej klasie. W przypadku interakcji użytkownika z wieloma punktami kontaktu (np. kilka palców poruszających się jednocześnie po ekranie) należy użyć powiązanych klas GestureEvent, PressAndTapGestureEvent i TransformGestureEvent. Należy także używać właściwości i metod tych klas w celu tworzenia modułów obsługi zdarzeń, które będą reagowały na gesty wykonywane na urządzeniu.
Klasa Multitouch służy do określania funkcji bieżącego środowiska przeznaczonych do interakcji dotykowych, a także do zarządzania funkcjami obsługi interakcji dotykowych, jeśli bieżące środowisko obsługuje je.
Uwaga: Gdy obiekty są zagnieżdżone na liście wyświetlania, wówczas obiektami docelowymi dla zdarzeń dotyku są najgłębiej zagnieżdżone obiekty, które są widoczne na liście wyświetlania. Taki obiekt jest nazywany węzłem docelowym. Aby umożliwić obiektowi nadrzędnemu (obiekt zawierający węzeł docelowy na liście wyświetlania) węzła docelowego odbieranie powiadomień na temat zdarzeń dotyku, należy użyć metody EventDispatcher.addEventListener() w węźle nadrzędnym z parametrem type ustawionym na zdarzenie dotyku, które ma zostać wykryte.
W środowisku AIR 3 i nowszych wersjach można wykrywać zdarzenia zbliżenia na obsługiwanych urządzeniach z systemem Android, które są wyposażone w pisak aktywny. Na takich urządzeniach obiekty zdarzeń proximityMove i touchMove udostępniają tablicę bajtów zawierającą próbki ścieżki i nacisku pobrane od poprzedniego zdarzenia przemieszczenia. Za pomocą tych próbek można skonstruować ścieżkę przemieszczania pisaka między zdarzeniami dotyku. (Testowanie naciśnięcia podczas interakcji pisaka z listą wyświetlania odbywa się tylko na końcu segmentu ścieżki).
Powiązane elementy interfejsu API
flash.ui.Multitouch
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Właściwości publiczne
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| altKey : Boolean
Określa, czy klawisz Alt jest aktywny (true), czy nieaktywny (false). | TouchEvent | ||
 | bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | |
| cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | |
| commandKey : Boolean
Określa, czy klawisz Command jest aktywny (tylko na komputerach Mac). | TouchEvent | ||
| constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| controlKey : Boolean
Określa, czy klawisz Control jest aktywny w systemie Mac lub czy klawisz Ctrl jest aktywny w systemie Windows lub Linux. | TouchEvent | ||
| ctrlKey : Boolean
W systemach Windows lub Linux określa, czy klawisz Ctrl jest aktywny (true), czy nieaktywny (false). | TouchEvent | ||
| currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | |
| eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | |
| isPrimaryTouchPoint : Boolean
Wskazuje, czy pierwszy punkt kontaktu jest odwzorowywany na zdarzenia myszy. | TouchEvent | ||
| isRelatedObjectInaccessible : Boolean
Jeśli wartość to true, właściwość relatedObject zostanie ustawiona na wartość null z przyczyn związanych z bezpiecznymi obszarami izolowanymi. | TouchEvent | ||
| isTouchPointCanceled : Boolean
Zgłasza, że system operacyjny anulował tę sekwencję dotknięć. | TouchEvent | ||
| localX : Number
Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). | TouchEvent | ||
| localY : Number
Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). | TouchEvent | ||
| pressure : Number
Wartość z zakresu 0,0 i 1,0 wskazująca siłę nacisku na urządzenie. | TouchEvent | ||
| relatedObject : InteractiveObject
Odwołanie do listy powiązanej ze zdarzeniem. | TouchEvent | ||
| shiftKey : Boolean
Określa, czy klawisz Shift jest aktywny (true), czy nieaktywny (false). | TouchEvent | ||
| sizeX : Number
Szerokość obszaru kontaktu. | TouchEvent | ||
| sizeY : Number
Wysokość obszaru kontaktu. | TouchEvent | ||
| stageX : Number [tylko do odczytu]
Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). | TouchEvent | ||
| stageY : Number [tylko do odczytu]
Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). | TouchEvent | ||
| target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | |
| timestamp : Number
Zgłasza względny czas zdarzenia w milisekundach. | TouchEvent | ||
| touchIntent : String
Wskazuje, czy dotknięcie zostało wygenerowane przez cienką, czy szeroką końcówkę pisaka. | TouchEvent | ||
| touchPointID : int
Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. | TouchEvent | ||
| type : String [tylko do odczytu]
Typ zdarzenia. | Event | |
Metody publiczne
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
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)
Tworzy obiekt Event, który zawiera informacje o zdarzeniach dotyku. | TouchEvent | ||
[przesłanianie]
Tworzy kopię obiektu TouchEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału. | TouchEvent | ||
|
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | |
Aktualizuje określony obiekt ByteArray przy użyciu punktów danych rejestrowanych z wysoką częstotliwością w przypadku zdarzenia dotyku wielopunktowego. | TouchEvent | ||
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Zgłasza naciśnięcie przycisku sprzętowego z określonym indeksem. | TouchEvent | ||
|
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | |
|
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
[przesłanianie]
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu TouchEvent. | TouchEvent | ||
Powoduje, że po zakończeniu przetwarzania tego zdarzenia program Flash Player lub środowisko wykonawcze Adobe AIR zrenderuje obraz, jeśli lista wyświetlania została zmodyfikowana. | TouchEvent | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
Stałe publiczne
| Stała | Zdefiniowane przez | ||
|---|---|---|---|
| PROXIMITY_BEGIN : String = "proximityBegin" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_BEGIN. | TouchEvent | ||
| PROXIMITY_END : String = "proximityEnd" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_END. | TouchEvent | ||
| PROXIMITY_MOVE : String = "proximityMove" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_MOVE. | TouchEvent | ||
| PROXIMITY_OUT : String = "proximityOut" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_OUT. | TouchEvent | ||
| PROXIMITY_OVER : String = "proximityOver" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_OVER. | TouchEvent | ||
| PROXIMITY_ROLL_OUT : String = "proximityRollOut" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_ROLL_OUT. | TouchEvent | ||
| PROXIMITY_ROLL_OVER : String = "proximityRollOver" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku PROXIMITY_ROLL_OVER. | TouchEvent | ||
| TOUCH_BEGIN : String = "touchBegin" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_BEGIN. | TouchEvent | ||
| TOUCH_END : String = "touchEnd" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_END. | TouchEvent | ||
| TOUCH_MOVE : String = "touchMove" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_MOVE. | TouchEvent | ||
| TOUCH_OUT : String = "touchOut" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_OUT. | TouchEvent | ||
| TOUCH_OVER : String = "touchOver" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_OVER. | TouchEvent | ||
| TOUCH_ROLL_OUT : String = "touchRollOut" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_ROLL_OUT. | TouchEvent | ||
| TOUCH_ROLL_OVER : String = "touchRollOver" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_ROLL_OVER. | TouchEvent | ||
| TOUCH_TAP : String = "touchTap" [statyczny]
Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku TOUCH_TAP. | TouchEvent | ||
Szczegół właściwości
altKey | właściwość |
altKey:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Określa, czy klawisz Alt jest aktywny (true), czy nieaktywny (false). Obsługiwany tylko w systemach operacyjnych Windows i Linux.
Implementacja
public function get altKey():Boolean public function set altKey(value:Boolean):voidcommandKey | właściwość |
commandKey:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
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.
Implementacja
public function get commandKey():Boolean public function set commandKey(value:Boolean):voidcontrolKey | właściwość |
controlKey:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Określa, czy klawisz Control jest aktywny w systemie Mac lub czy klawisz Ctrl jest aktywny w systemie Windows lub Linux.
Implementacja
public function get controlKey():Boolean public function set controlKey(value:Boolean):voidctrlKey | właściwość |
ctrlKey:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
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.
Implementacja
public function get ctrlKey():Boolean public function set ctrlKey(value:Boolean):voidisPrimaryTouchPoint | właściwość |
isPrimaryTouchPoint:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Wskazuje, czy pierwszy punkt kontaktu jest odwzorowywany na zdarzenia myszy.
Implementacja
public function get isPrimaryTouchPoint():Boolean public function set isPrimaryTouchPoint(value:Boolean):voidPowiązane elementy interfejsu API
isRelatedObjectInaccessible | właściwość |
isRelatedObjectInaccessible:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Implementacja
public function get isRelatedObjectInaccessible():Boolean public function set isRelatedObjectInaccessible(value:Boolean):voidPowiązane elementy interfejsu API
isTouchPointCanceled | właściwość |
isTouchPointCanceled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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.
Implementacja
public function get isTouchPointCanceled():Boolean public function set isTouchPointCanceled(value:Boolean):voidlocalX | właściwość |
localY | właściwość |
pressure | właściwość |
pressure:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Implementacja
public function get pressure():Number public function set pressure(value:Number):voidrelatedObject | właściwość |
relatedObject:InteractiveObject| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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().
Implementacja
public function get relatedObject():InteractiveObject public function set relatedObject(value:InteractiveObject):voidPowiązane elementy interfejsu API
shiftKey | właściwość |
sizeX | właściwość |
sizeY | właściwość |
stageX | właściwość |
stageX:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Implementacja
public function get stageX():NumberstageY | właściwość |
stageY:Number [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Implementacja
public function get stageY():Number timestamp | właściwość |
timestamp:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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.
Implementacja
public function get timestamp():Number public function set timestamp(value:Number):voidPowiązane elementy interfejsu API
touchIntent | właściwość |
touchIntent:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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
Implementacja
public function get touchIntent():String public function set touchIntent(value:String):voidPowiązane elementy interfejsu API
touchPointID | właściwość |
touchPointID:int| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku.
Implementacja
public function get touchPointID():int public function set touchPointID(value:int):voidPrzykład ( Sposób korzystania z tego przykładu )
W poniższym przykładzie tworzona jest zmienna
touchMoveID służąca do sprawdzania, czy wartość touchPointID jest prawidłowa, przed podjęciem reakcji na przemieszczanie punktu dotyku. Jeśli wartość jest nieprawidłowa, inne dotknięcia także wywołają funkcję obsługi zdarzenia. Należy zwrócić uwagę, że detektory faz przemieszczania i zakończenia, są metodami stołu montażowego, a nie obiektu wyświetlanego. Stół montażowy wykrywa fazy przemieszczania i zakończenia także wtedy, gdy użytkownik dotyka punktów poza obwiednią obiektu wyświetlanego.
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;
}
Konstruktor Szczegół
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)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Tworzy obiekt Event, który zawiera informacje o zdarzeniach dotyku. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.
Parametrytype:String — Typ zdarzenia. Możliwe wartości: 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 i TouchEvent.TOUCH_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
touchPointID:int (default = 0) | |
isPrimaryTouchPoint:Boolean (default = false) | |
localX:Number (default = NaN) | |
localY:Number (default = NaN) | |
sizeX:Number (default = NaN) | |
sizeY:Number (default = NaN) | |
pressure:Number (default = NaN)0,0 i 1,0 wskazująca siłę nacisku na urządzenie. Jeśli urządzenie nie wykrywa nacisku, wartość jest równa 1,0.
| |
relatedObject:InteractiveObject (default = null)touchOut, właściwość relatedObject reprezentuje obiekt listy wyświetlania wskazywany teraz przez urządzenie wskazujące.
| |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) | |
timestamp:Number (default = NaN) | |
touchIntent:String (default = NaN) | |
samples:ByteArray (default = null) | |
isTouchPointCanceled:Boolean (default = false)true, jeśli zdarzenie dotyku zostało anulowane z powodu odrzucenia typu dotyku.
|
Szczegół metody
clone | () | metoda |
override public function clone():Event| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Tworzy kopię obiektu TouchEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.
ZwracaEvent — Nowy obiekt TouchEvent z wartościami właściwości zgodnymi z oryginałem.
|
getSamples | () | metoda |
public function getSamples(buffer:ByteArray, append:Boolean = false):uint| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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
buffer:ByteArray — Obiekt ByteArray, do którego należy przekazać dane próbek.
| |
append:Boolean (default = false)true próbki są dodawane do tablicy bajtów buffer, począwszy od bieżącej wartości właściwości position tablicy. W przypadku wartości false (domyślnej) istniejące dane w obiekcie bufora są odrzucane przed dodaniem próbek.
|
uint — Liczba próbek dodanych do bufora. Każda próbka składa się z trzech liczb zmiennoprzecinkowych.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Poniższy przykład ilustruje sposób pobierania przykładowych danych ze zdarzenia touchMove lub proximityMove.
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
}
}
}
Poniższy przykład ilustruje sposób pobierania przykładowych danych ze zdarzenia touchMove lub proximityMove. W tym przykładzie przykładowe dane są dołączane do istniejącej tablicy bajtów.
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 | () | metoda |
public function isToolButtonDown(index:int):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
Zgłasza naciśnięcie przycisku sprzętowego z określonym indeksem.
Parametry
index:int — Liczony od zera indeks przycisków obsługiwanych przez urządzenie wejściowe w formie pisaka.
|
Boolean |
toString | () | metoda |
override public function toString():String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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ść ... ]
String — Ciąg znaków, który zawiera wszystkie właściwości obiektu TouchEvent.
|
updateAfterEvent | () | metoda |
public function updateAfterEvent():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Szczegół stałej
PROXIMITY_BEGIN | Stała |
public static const PROXIMITY_BEGIN:String = "proximityBegin"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
PROXIMITY_END | Stała |
public static const PROXIMITY_END:String = "proximityEnd"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
PROXIMITY_MOVE | Stała |
public static const PROXIMITY_MOVE:String = "proximityMove"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
PROXIMITY_OUT | Stała |
public static const PROXIMITY_OUT:String = "proximityOut"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
PROXIMITY_OVER | Stała |
public static const PROXIMITY_OVER:String = "proximityOver"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
PROXIMITY_ROLL_OUT | Stała |
public static const PROXIMITY_ROLL_OUT:String = "proximityRollOut"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
PROXIMITY_ROLL_OVER | Stała |
public static const PROXIMITY_ROLL_OVER:String = "proximityRollOver"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
timestamp | (Tylko w środowisku AIR) Znacznik czasowy zdarzenia (w milisekundach) względem momentu uruchomienia aplikacji. |
touchIntent | (Tylko w środowisku AIR) Wartość z klasy TouchEventIntent. |
isTouchPointCanceled | (Tylko w środowisku AIR) Wartość true, jeśli zdarzenie dotyku zostało anulowane w związku z logiką odrzucania dotknięć przez urządzenie. |
Powiązane elementy interfejsu API
TOUCH_BEGIN | Stała |
public static const TOUCH_BEGIN:String = "touchBegin"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
TOUCH_END | Stała |
public static const TOUCH_END:String = "touchEnd"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
TOUCH_MOVE | Stała |
public static const TOUCH_MOVE:String = "touchMove"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
TOUCH_OUT | Stała |
public static const TOUCH_OUT:String = "touchOut"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
TOUCH_OVER | Stała |
public static const TOUCH_OVER:String = "touchOver"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
TOUCH_ROLL_OUT | Stała |
public static const TOUCH_ROLL_OUT:String = "touchRollOut"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
TOUCH_ROLL_OVER | Stała |
public static const TOUCH_ROLL_OVER:String = "touchRollOver"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
TOUCH_TAP | Stała |
public static const TOUCH_TAP:String = "touchTap"| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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:
| Właściwość | Wartość |
|---|---|
altKey | true, jeśli klawisz Alt jest aktywny (Windows lub Linux). |
bubbles | true |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
eventPhase | Bieżąca faza przepływu zdarzeń. |
isRelatedObjectInaccessible | true, jeśli właściwość relatedObject jest ustawiona na null z powodu reguł obszaru izolowanego. |
localX | Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki). |
localY | Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki). |
pressure | 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. |
relatedObject | Odwołanie do obiektu listy wyświetlanej powiązanej ze zdarzeniem. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
sizeX | Szerokość obszaru kontaktu. |
sizeY | Wysokość obszaru kontaktu. |
stageX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
stageY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego). |
target | Instancja klasy InteractiveObject pod urządzeniem dotykowym. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
touchPointID | Unikalny numer identyfikacyjny (taki jak liczba całkowita) przypisany do punktu dotyku. |
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
Poniższy przykład prezentuje wyświetlanie komunikatu w przypadku stuknięcia kwadratu narysowanego na ikonce mySprite na ekranie dotykowym:
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);
}
Przykłady Sposób korzystania z tego przykładu
TouchEventExample.as
Poniższy przykład ilustruje obsługę zdarzeń
TOUCH_BEGIN, TOUCH_MOVE i TOUCH_END. W miarę, jak punkt kontaktu przesuwa się po ekranie (onTouchMove), wyświetlane są (za pomocą funkcji trace) współrzędne x względem stołu montażowego. W parametrach Sprite.startTouchDrag funkcji onTouchBegin wartość touchPointID jest wartością przypisaną do obiektu zdarzenia. Parametr bounds to prostokąt definiujący granice nadrzędnego obiektu wyświetlanego (bg to obiekt wyświetlany zawierający obiekt MySprite).
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
W poniższym przykładzie przedstawiono sposób obsługi zdarzeń dotyku oraz ich faz, a także właściwość
Multitouch.maxTouchPoints oraz właściwości obiektu zdarzenia dotyku touchPointID. Autorem tego przykładu jest Christian Cantrell, a jego szczegółowe omówienie można znaleźć na stronie: Multi-touch and gesture support on the Flash Platform (Obsługa interfejsu Multi-Touch oraz gestów na platformie Flash).
package
{
import flash.display.Sprite;
import flash.events.TouchEvent;
import flash.text.AntiAliasType;
import flash.text.TextField;
import flash.text.TextFormat;
import flash.ui.Multitouch;
import flash.ui.MultitouchInputMode;
[SWF(width=320, height=460, frameRate=24, backgroundColor=0xEB7F00)]
public class TouchExample2 extends Sprite
{
private var dots:Object;
private var labels:Object;
private var labelFormat:TextFormat;
private var dotCount:uint;
private var dotsLeft:TextField;
private static const LABEL_SPACING:uint = 15;
public function TouchExample2()
{
super();
this.labelFormat = new TextFormat();
labelFormat.color = 0xACF0F2;
labelFormat.font = "Helvetica";
labelFormat.size = 11;
this.dotCount = 0;
this.dotsLeft = new TextField();
this.dotsLeft.width = 300;
this.dotsLeft.defaultTextFormat = this.labelFormat;
this.dotsLeft.x = 3;
this.dotsLeft.y = 0;
this.stage.addChild(this.dotsLeft);
this.updateDotsLeft();
this.dots = new Object();
this.labels = new Object();
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
this.stage.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
this.stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
this.stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
}
private function onTouchBegin(e:TouchEvent):void
{
if (this.dotCount == Multitouch.maxTouchPoints) return;
var dot:Sprite = this.getCircle();
dot.x = e.stageX;
dot.y = e.stageY;
this.stage.addChild(dot);
dot.startTouchDrag(e.touchPointID, true);
this.dots[e.touchPointID] = dot;
++this.dotCount;
var label:TextField = this.getLabel(e.stageX + ", " + e.stageY);
label.x = 3;
label.y = this.dotCount * LABEL_SPACING;
this.stage.addChild(label);
this.labels[e.touchPointID] = label;
this.updateDotsLeft();
}
private function onTouchMove(e:TouchEvent):void
{
var label:TextField = this.labels[e.touchPointID];
label.text = (e.stageX + ", " + e.stageY);
}
private function onTouchEnd(e:TouchEvent):void
{
var dot:Sprite = this.dots[e.touchPointID];
var label:TextField = this.labels[e.touchPointID];
this.stage.removeChild(dot);
this.stage.removeChild(label);
delete this.dots[e.touchPointID];
delete this.labels[e.touchPointID];
--this.dotCount;
this.updateDotsLeft();
}
private function getCircle(circumference:uint = 40):Sprite
{
var circle:Sprite = new Sprite();
circle.graphics.beginFill(0x1695A3);
circle.graphics.drawCircle(0, 0, circumference);
return circle;
}
private function getLabel(initialText:String):TextField
{
var label:TextField = new TextField();
label.defaultTextFormat = this.labelFormat;
label.selectable = false;
label.antiAliasType = AntiAliasType.ADVANCED;
label.text = initialText;
return label;
}
private function updateDotsLeft():void
{
this.dotsLeft.text = "Touches Remaining: " + (Multitouch.maxTouchPoints - this.dotCount);
}
}
}
Tue Jun 12 2018, 12:06 PM Z