PressAndTapGestureEvent

套件	flash.events
類別	public class PressAndTapGestureEvent
繼承	PressAndTapGestureEvent GestureEvent Event Object

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

PressAndTapGestureEvent 類別可讓您處理觸控裝置上的按下並輕點手勢。從 InteractiveObject 類別繼承屬性的物件會在傳送的事件物件中捕捉主要觸控點 (按) 以及次要觸控點 (輕點)。按下並輕點手勢通常用來顯示快顯選單。

檢視範例

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		altKey : Boolean 指出 Alt 鍵為作用中 (true) 或停用 (false)。	GestureEvent
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		commandKey : Boolean 指出 Command 鍵是否已啟用 (僅限 Mac)。	GestureEvent
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		controlKey : Boolean 指出是否已啟用 Control 鍵 (在 Mac 中) 以及是否已啟用 Ctrl 鍵 (在 Windows 或 Linux 中)。	GestureEvent
		ctrlKey : Boolean 在 Windows 或 Linux 中，指出 Ctrl 鍵為作用中 (true) 或已停用 (false)。	GestureEvent
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		localX : Number 相對於包含的 sprite，事件發生的水平座標。	GestureEvent
		localY : Number 相對於包含的 sprite，事件發生的垂直座標。	GestureEvent
		phase : String GesturePhase 類別的值，指出觸控手勢的進度。	GestureEvent
		shiftKey : Boolean 指出 Shift 鍵為作用中 (true) 或停用 (false)。	GestureEvent
		stageX : Number [唯讀] 在全域舞台座標上，事件發生的水平座標。	GestureEvent
		stageY : Number [唯讀] 在全域舞台座標上，事件發生的垂直座標。	GestureEvent
		tapLocalX : Number 相對於包含的互動式物件，事件發生的水平座標。	PressAndTapGestureEvent
		tapLocalY : Number 相對於包含的互動式物件，事件發生的垂直座標。	PressAndTapGestureEvent
		tapStageX : Number [唯讀] 在全域舞台座標上，發生輕點觸碰的水平座標。	PressAndTapGestureEvent
		tapStageY : Number [唯讀] 在全域舞台座標上，發生輕點觸碰的垂直座標。	PressAndTapGestureEvent
		target : Object [唯讀] 事件目標。	Event
		type : String [唯讀] 事件類型。	Event

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		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) 建立包含複雜多點觸控事件 (例如使用者引發快顯選單) 相關資訊的 Event 物件。	PressAndTapGestureEvent
		clone():Event [覆寫] 建立 PressAndTapGestureEvent 物件的副本，然後設定每個屬性值以符合原始物件的屬性值。	PressAndTapGestureEvent
		formatToString(className:String, ... arguments):String 公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。	Event
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isDefaultPrevented():Boolean 檢查是否已經對事件呼叫 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		preventDefault():void 如果可以取消事件的預設行為指令，則取消該行為指令。	Event
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		stopImmediatePropagation():void 避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。	Event
		stopPropagation():void 避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。	Event
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String [覆寫] 傳回包含 PressAndTapGestureEvent 物件所有屬性的字串。	PressAndTapGestureEvent
		updateAfterEvent():void 假設事件處理常式已經修改顯示清單，在處理手勢事件後，重新整理 Flash 執行階段顯示。	GestureEvent
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		GESTURE_PRESS_AND_TAP : String = "gesturePressAndTap" [靜態] 定義 GESTURE_PRESS_AND_TAP 觸控事件物件的 type 屬性值。	PressAndTapGestureEvent

屬性詳細資訊

tapLocalX

屬性

tapLocalX:Number

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

相對於包含的互動式物件，事件發生的水平座標。

實作
public function get tapLocalX():Number
public function set tapLocalX(value:Number):void

tapLocalY

屬性

tapLocalY:Number

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

相對於包含的互動式物件，事件發生的垂直座標。

實作
public function get tapLocalY():Number
public function set tapLocalY(value:Number):void

tapStageX

屬性

tapStageX:Number [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

在全域舞台座標上，發生輕點觸碰的水平座標。每次設定 tapLocalX 屬性時，就會計算這個屬性。

實作
public function get tapStageX():Number

tapStageY

屬性

tapStageY:Number [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

在全域舞台座標上，發生輕點觸碰的垂直座標。每次設定 tapLocalX 屬性時，就會計算這個屬性。

實作
public function get tapStageY():Number

建構函式詳細資料

()

建構函式

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)

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

建立包含複雜多點觸控事件 (例如使用者引發快顯選單) 相關資訊的 Event 物件。Event 物件會當做參數傳遞至事件偵聽程式。

參數

	`type:String` — 事件的類型：`PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP`。

	`bubbles:Boolean` (default = `true`) — 判斷事件物件是否參與事件流程的反昇階段。

	`cancelable:Boolean` (default = `false`) — 判斷是否可以取消 Event 物件。

	`phase:String` (default = `null`) — 這個數值會追蹤觸控手勢的開始、進度與結束。可能的值包括：`GesturePhase.BEGIN`、`GesturePhase.END`、`GesturePhase.UPDATE` 或 `GesturePhase.ALL`。

	`localX:Number` (default = `0`) — 相對於包含的顯示物件，事件發生的水平座標。

	`localY:Number` (default = `0`) — 相對於包含的顯示物件，事件發生的垂直座標。

	`tapLocalX:Number` (default = `0`) — 相對於包含的互動式物件，事件發生的水平座標。

	`tapLocalY:Number` (default = `0`) — 相對於包含的互動式物件，事件發生的垂直座標。

	`ctrlKey:Boolean` (default = `false`) — 在 Windows 或 Linux 中，表示是否已啟用 Ctrl 鍵。在 Mac 中，指出已啟用 Ctrl 鍵或 Command 鍵。

	`altKey:Boolean` (default = `false`) — 指出是否已啟用 Alt 鍵 (僅限 Windows 或 Linux)。

	`shiftKey:Boolean` (default = `false`) — 指出是否已啟用 Shift 鍵。

	`commandKey:Boolean` (default = `false`) — (僅限 AIR) 指出 Command 鍵是否已啟用 (僅限 Mac)。這個參數僅適用於 Adobe AIR；請勿針對 Flash Player 內容設定此參數。

	`controlKey:Boolean` (default = `false`) — (僅限 AIR) 指出 Control 或 Ctrl 鍵是否已啟用。這個參數僅適用於 Adobe AIR；請勿針對 Flash Player 內容設定此參數。

方法詳細資訊

clone

()

方法

override public function clone():Event

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

建立 PressAndTapGestureEvent 物件的副本，然後設定每個屬性值以符合原始物件的屬性值。

傳回值

Event — 新的 PressAndTapGestureEvent 物件，其屬性值符合原始物件的屬性值。

toString

()

方法

override public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

傳回包含 PressAndTapGestureEvent 物件所有屬性的字串。此字串的格式如下：

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

傳回值

String — 包含 PressAndTapGestureEvent 物件所有屬性的字串。

常數詳細資訊

GESTURE_PRESS_AND_TAP

常數

public static const GESTURE_PRESS_AND_TAP:String = "gesturePressAndTap"

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 10.1, AIR 2, Flash Lite 4

定義 GESTURE_PRESS_AND_TAP 觸控事件物件的 type 屬性值。

傳送的 PressAndTapGestureEvent 物件有下列屬性：

屬性	值
`altKey`	如果 Alt 鍵為作用中 (Windows 或 Linux)，則為 `true`。
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`commandKey`	在 Mac 中，如果 Command 鍵為作用中，則為 `true`；如果已停用則為 `false`。在 Windows 中一定為 `false`。
`controlKey`	如果 Ctrl 或 Control 鍵為作用中，則為 `true`；如果已停用，則為 `false`。
`ctrlKey`	在 Windows 或 Linux 中，如果 Ctrl 鍵為作用中，則為 `true`；在 Mac 中，如果 Ctrl 鍵或 Command 鍵為作用中，則為 `true`；否則為 `false`。
`currentTarget`	正主動使用事件偵聽程式處理 Event 物件的物件。
`eventPhase`	目前階段會以事件通過物件階層，數值會指出事件被擷取 (1)、在目標 (2) 或反昇 (3)。
`localX`	相對於包含的顯示物件，事件發生的水平座標。
`localY`	相對於包含的顯示物件，事件發生的垂直座標。
`phase`	事件流程的目前階段；GesturePhase 類別的值。可能的值包括：`GesturePhase.BEGIN`、`GesturePhase.UPDATE`、`GesturePhase.END` 或 `GesturePhase.ALL`。按下並輕點手勢會產生 `GesturePhase.BEGIN`、`GesturePhase.UPDATE`、`GesturePhase.END` 序列，或是手勢會產生單一 `GesturePhase.ALL` 階段。
`shiftKey`	如果 Shift 鍵為作用中，則為 `true`；若已停用，則為 `false`。
`stageX`	在全域舞台座標上，事件發生的水平座標。
`stageY`	在全域舞台座標上，事件發生的垂直座標。
`tapLocalX`	相對於包含的互動式物件，事件發生的水平座標。
`tapLocalY`	相對於包含的互動式物件，事件發生的垂直座標。
`tapStageX`	在全域舞台座標上，發生輕點觸碰的水平座標。
`tapStageY`	在全域舞台座標上，發生輕點觸碰的垂直座標。
`target`	位於觸控裝置下方的 InteractiveObject 實體。`target` 不會永遠都是顯示清單中註冊事件偵聽程式的物件。請使用 `currentTarget` 屬性，存取目前正在處理該事件之顯示清單中的物件。

範例如何使用本範例

GesturePressAndTap.as

以下範例顯示 GESTURE_PRESS_AND_TAP 事件的事件處理。當使用者執行按下並輕點手勢時，mySprite 會旋轉而 myTextField 會填入目前的階段。

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

法律聲明 | 線上隱私權政策

PressAndTapGestureEvent - AS3

類別 x

tapLocalX

tapLocalY

tapStageX

tapStageY