PressAndTapGestureEvent

Pakiet	flash.events
Klasa	public class PressAndTapGestureEvent
Dziedziczenie	PressAndTapGestureEvent GestureEvent Event Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10.1, AIR 2, Flash Lite 4

Klasa PressAndTapGestureEvent umożliwia obsługę gestu naciśnięcia i stuknięcia na urządzeniach dotykowych. Obiekty, które dziedziczą właściwości z klasy InteractiveObject, przechwytują podstawowy punkt dotknięcia (naciśnięcia) i dodatkowy punkt dotknięcia (stuknięcia) w obiekcie wywoływanego zdarzenia. Gest naciśnięcia i stuknięcia jest zwykle używany do wywołania menu kontekstowego.

Wyświetl przykłady

Powiązane elementy interfejsu API

flash.ui.Multitouch
flash.display.InteractiveObject
flash.events.TouchEvent
flash.events.GestureEvent
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).	GestureEvent
		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).	GestureEvent
		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.	GestureEvent
		ctrlKey : Boolean W systemach Windows lub Linux określa, czy klawisz Ctrl jest aktywny (true), czy nieaktywny (false).	GestureEvent
		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
		localX : Number Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem ikonki).	GestureEvent
		localY : Number Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem ikonki).	GestureEvent
		phase : String Wartość z klasy GesturePhase wskazująca postęp gestu dotyku.	GestureEvent
		shiftKey : Boolean Określa, czy klawisz Shift jest aktywny (true), czy nieaktywny (false).	GestureEvent
		stageX : Number [tylko do odczytu] Współrzędna pozioma miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego).	GestureEvent
		stageY : Number [tylko do odczytu] Współrzędna pionowa miejsca wystąpienia zdarzenia (w globalnym układzie współrzędnych stołu montażowego).	GestureEvent
		tapLocalX : Number Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu interaktywnego).	PressAndTapGestureEvent
		tapLocalY : Number Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu interaktywnego).	PressAndTapGestureEvent
		tapStageX : Number [tylko do odczytu] Współrzędna pozioma miejsca wystąpienia stuknięcia (w globalnym układzie współrzędnych stołu montażowego).	PressAndTapGestureEvent
		tapStageY : Number [tylko do odczytu] Współrzędna pionowa miejsca wystąpienia stuknięcia (w globalnym układzie współrzędnych stołu montażowego).	PressAndTapGestureEvent
		target : Object [tylko do odczytu] Miejsce docelowe zdarzenia.	Event
		type : String [tylko do odczytu] Typ zdarzenia.	Event

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		PressAndTapGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, tapLocalX:Number = 0, tapLocalY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false) Tworzy obiekt Event zawierający informacje o złożonych zdarzeniach dotyku Multi-Touch, takich jak wywołanie menu kontekstowego.	PressAndTapGestureEvent
		clone():Event [przesłanianie] Tworzy kopię obiektu PressAndTapGestureEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.	PressAndTapGestureEvent
		formatToString(className:String, ... arguments):String Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0.	Event
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isDefaultPrevented():Boolean Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		preventDefault():void Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane.	Event
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		stopImmediatePropagation():void Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim.	Event
		stopPropagation():void Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń.	Event
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String [przesłanianie] Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu PressAndTapGestureEvent.	PressAndTapGestureEvent
		updateAfterEvent():void Odświeża ekran środowiska wykonawczego Flash po przetworzeniu zdarzenia gestu, jeśli lista wyświetlania została zmodyfikowana przez funkcję obsługi zdarzenia.	GestureEvent
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object

Stałe publiczne

Ukryj dziedziczone stałe publiczne

Pokaż dziedziczone stałe publiczne

	Stała		Zdefiniowane przez
		GESTURE_PRESS_AND_TAP : String = "gesturePressAndTap" [statyczny] Definiuje wartość właściwości type dotyczącej obiektu zdarzenia dotyku GESTURE_PRESS_AND_TAP.	PressAndTapGestureEvent

Szczegół właściwości

tapLocalX

właściwość

tapLocalX:Number

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 (określana względem zawierającego obiektu interaktywnego).

Implementacja
public function get tapLocalX():Number
public function set tapLocalX(value:Number):void

tapLocalY

właściwość

tapLocalY:Number

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 (określana względem zawierającego dany element obiektu interaktywnego).

Implementacja
public function get tapLocalY():Number
public function set tapLocalY(value:Number):void

tapStageX

właściwość

tapStageX: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 stuknięcia (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 tapLocalY.

Implementacja
public function get tapStageX():Number

tapStageY

właściwość

tapStageY: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 stuknięcia (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 tapLocalY.

Implementacja
public function get tapStageY():Number

Konstruktor Szczegół

()

Konstruktor

public function PressAndTapGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, tapLocalX:Number = 0, tapLocalY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 10.1, AIR 2, Flash Lite 4

Tworzy obiekt Event zawierający informacje o złożonych zdarzeniach dotyku Multi-Touch, takich jak wywołanie menu kontekstowego. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.

Parametry

	`type:String` — Typ zdarzenia: `PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP`.

	`bubbles:Boolean` (default = `true`) — Określa, czy obiekt Event uczestniczy w fazie propagacji przepływu zdarzeń.

	`cancelable:Boolean` (default = `false`) — Określa, czy obiekt Event może być anulowany.

	`phase:String` (default = `null`) — Te wartości śledzą początek, postęp i koniec gestu. Możliwe wartości to: `GesturePhase.BEGIN`, `GesturePhase.END`, `GesturePhase.UPDATE` i `GesturePhase.ALL`.

	`localX:Number` (default = `0`) — Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego obiektu ekranowego).

	`localY:Number` (default = `0`) — Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego obiektu ekranowego).

	`tapLocalX:Number` (default = `0`) — Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego obiektu interaktywnego).

	`tapLocalY:Number` (default = `0`) — Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu interaktywnego).

	`ctrlKey:Boolean` (default = `false`) — W systemie Windows lub Linux określa, czy klawisz Ctrl jest aktywny. W systemie Mac określa, czy aktywny jest klawisz Ctrl lub Command.

	`altKey:Boolean` (default = `false`) — Określa, czy klawisz Alt jest aktywny (tylko w systemach Windows i Linux).

	`shiftKey:Boolean` (default = `false`) — Określa, czy klawisz Shift jest aktywny.

	`commandKey:Boolean` (default = `false`) — (Tylko w środowisku AIR) Wskazuje, czy klawisz Command jest aktywny (tylko w systemach Mac). Ten parametr jest przeznaczony tylko dla środowiska Adobe AIR; nie należy go ustawiać dla treści programu Flash Player.

	`controlKey:Boolean` (default = `false`) — (Tylko środowisko AIR) Określa, czy klawisz Control lub Ctrl jest aktywny. Ten parametr jest przeznaczony tylko dla środowiska Adobe AIR. Nie należy go ustawiać dla zawartości programu Flash Player.

Powiązane elementy interfejsu API

flash.ui.Multitouch
flash.events.TouchEvent
flash.events.GestureEvent
flash.events.GesturePhase
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()

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 PressAndTapGestureEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.

Zwraca

Event — Nowy obiekt PressAndTapGestureEvent z wartościami właściwości zgodnymi z oryginałem.

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 PressAndTapGestureEvent. Format ciągu znaków jest następujący:

[PressAndTapGestureEvent type=value bubbles=value cancelable=value ... ]

Zwraca

String — Ciąg znaków, który zawiera wszystkie właściwości obiektu PressAndTapGestureEvent.

Szczegół stałej

GESTURE_PRESS_AND_TAP

Stała

public static const GESTURE_PRESS_AND_TAP:String = "gesturePressAndTap"

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

Wywołany obiekt PressAndTapGestureEvent 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 obsługi zdarzenia przechodzącego przez hierarchię obiektów; wartość liczbowa określająca, czy zdarzenie jest w fazie przechwytywania (1), fazie celu (2), czy fazie propagacji (3).
`localX`	Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu ekranowego).
`localY`	Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu ekranowego).
`phase`	Bieżąca faza przepływu zdarzeń; wartość należąca do klasy GesturePhase. Możliwe wartości to: `GesturePhase.BEGIN`, `GesturePhase.UPDATE`, `GesturePhase.END` i `GesturePhase.ALL`. Gest naciśnięcia i stuknięcie generuje sekwencję faz `GesturePhase.BEGIN`, `GesturePhase.UPDATE`, `GesturePhase.END` albo pojedynczą fazę `GesturePhase.ALL`.
`shiftKey`	`true`, jeśli klawisz Shift jest aktywny; `false`, jeśli jest nieaktywny.
`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).
`tapLocalX`	Współrzędna pozioma miejsca wystąpienia zdarzenia (określana względem zawierającego dany element obiektu interaktywnego).
`tapLocalY`	Współrzędna pionowa miejsca wystąpienia zdarzenia (określana względem zawierającego obiektu interaktywnego).
`tapStageX`	Współrzędna pozioma miejsca wystąpienia stuknięcia (w globalnym układzie współrzędnych stołu montażowego).
`tapStageY`	Współrzędna pionowa miejsca wystąpienia stuknięcia (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.

Powiązane elementy interfejsu API

flash.display.InteractiveObject.gesturePressAndTap
flash.events.GesturePhase

Przykłady Sposób korzystania z tego przykładu

GesturePressAndTap.as

Poniższy przykład ilustruje obsługę zdarzenia GESTURE_PRESS_AND_TAP. Gdy użytkownik wykona gest naciśnięcia i stuknięcia, obiekt mySprite obróci się, a pole myTextField zostanie zapełnione informacją o aktualnej fazie obsługi.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP , onPressAndTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPressAndTap(evt:PressAndTapGestureEvent):void {

    evt.target.rotation -= 45;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Informacje prawne | Zasady prywatności online

PressAndTapGestureEvent - AS3

Klasy x

tapLocalX

tapLocalY

tapStageX

tapStageY