| 套件 | flash.events |
| 類別 | public class TouchEvent |
| 繼承 | TouchEvent Event Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
當使用者與具有觸控螢幕的行動電話或平板電腦互動時,使用者通常會利用手指或是指向裝置碰觸螢幕。您可以利用 TouchEvent 類別開發回應基本觸控事件 (例如單一手指點選) 的應用程式。使用在這個類別中定義的事件類型建立事件偵聽程式。對於多點接觸的使用者互動 (例如多隻手指同時滑過觸控螢幕),您可以使用相關的 GestureEvent、PressAndTapGestureEvent 與 TransformGestureEvent 類別。然後,利用這些類別的屬性和方法建構回應使用者觸控裝置的事件處理常式。
使用 Multitouch 類別判定目前環境支援觸控互動的程度,以及管理觸控互動的支援 (若目前環境支援)。
注意:當物件在顯示清單中巢狀排列時,觸控事件會指向在顯示清單中可見的最深層巢狀物件。這個物件稱為目標節點。若要讓目標節點的祖系 (包含顯示清單中目標節點的物件) 接收觸控事件的通知,請在祖系節點上使用 EventDispatcher.addEventListener() (將 type 參數設定為您要偵測的特定觸控事件)。
在 AIR 3 及更新的版本中,您可以在具有作用中觸控筆的 Android 支援裝置上偵聽鄰近事件。在這類裝置上,proximityMove 和 touchMove 事件物件提供位元組陣列,其中包含路徑及自上一個移動事件以來採取過的壓力取樣。您可以使用這些樣本,在觸控事件之間建構觸控筆的路徑 (請注意,觸控筆輸入與顯示清單之間互動的感應測試,只會在路徑線段結尾進行)。
相關 API 元素
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
| 屬性 | 定義自 | ||
|---|---|---|---|
| altKey : Boolean
指出 Alt 鍵為作用中 (true) 或停用 (false)。 | TouchEvent | ||
![]() | bubbles : Boolean [唯讀]
指出事件是否為反昇事件。 | Event | |
![]() | cancelable : Boolean [唯讀]
指出是否可避免與事件相關聯的行為指令。 | Event | |
| commandKey : Boolean
指出 Command 鍵是否已啟用 (僅限 Mac)。 | TouchEvent | ||
![]() | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| controlKey : Boolean
指出是否已啟用 Control 鍵 (在 Mac 中) 以及是否已啟用 Ctrl 鍵 (在 Windows 或 Linux 中)。 | TouchEvent | ||
| ctrlKey : Boolean
在 Windows 或 Linux 中,指出 Ctrl 鍵為作用中 (true) 或已停用 (false)。 | TouchEvent | ||
![]() | currentTarget : Object [唯讀]
正主動使用事件偵聽程式處理 Event 物件的物件。 | Event | |
![]() | eventPhase : uint [唯讀]
事件流程中的目前階段。 | Event | |
| isPrimaryTouchPoint : Boolean
指定第一個接觸點是否對應到滑鼠事件。 | TouchEvent | ||
| isRelatedObjectInaccessible : Boolean
如果是 true,則 relatedObject 屬性會因為安全執行程序的因素而設定為 null。 | TouchEvent | ||
| isTouchPointCanceled : Boolean
報告這個觸控輸入序列已由作業系統取消。 | TouchEvent | ||
| localX : Number
相對於包含的 sprite,事件發生的水平座標。 | TouchEvent | ||
| localY : Number
相對於包含的 sprite,事件發生的垂直座標。 | TouchEvent | ||
| pressure : Number
介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。 | TouchEvent | ||
| relatedObject : InteractiveObject
與事件相關的顯示清單物件的參照。 | TouchEvent | ||
| shiftKey : Boolean
指出 Shift 鍵為作用中 (true) 或停用 (false)。 | TouchEvent | ||
| sizeX : Number
接觸區域寬度。 | TouchEvent | ||
| sizeY : Number
接觸區域高度。 | TouchEvent | ||
| stageX : Number [唯讀]
在全域舞台座標上,事件發生的水平座標。 | TouchEvent | ||
| stageY : Number [唯讀]
在全域舞台座標上,事件發生的垂直座標。 | TouchEvent | ||
![]() | target : Object [唯讀]
事件目標。 | Event | |
| timestamp : Number
報告事件的時間 (相對毫秒)。 | TouchEvent | ||
| touchIntent : String
報告觸控是否由觸控筆的主要端點或橡皮擦端點所產生。 | TouchEvent | ||
| touchPointID : int
指派至觸控點的唯一識別碼 (作為 int)。 | TouchEvent | ||
![]() | type : String [唯讀]
事件類型。 | Event | |
| 方法 | 定義自 | ||
|---|---|---|---|
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)
建立包含關於觸控事件資訊的 Event 物件。 | TouchEvent | ||
[覆寫]
建立 TouchEvent 物件的副本,然後設定每個屬性值以符合原始物件的屬性值。 | TouchEvent | ||
![]() |
公用程式函數,可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。 | Event | |
請使用高頻率的資料點,為多點觸控事件更新指定的 ByteArray 物件。 | TouchEvent | ||
![]() |
指出物件是否有已定義的指定屬性。 | Object | |
![]() |
檢查是否已經對事件呼叫 preventDefault() 方法。 | Event | |
![]() |
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
報告已按下位於指定之索引位置的硬體按鈕。 | TouchEvent | ||
![]() |
如果可以取消事件的預設行為指令,則取消該行為指令。 | Event | |
![]() |
指出指定的屬性是否存在,以及是否可列舉。 | Object | |
![]() |
為迴圈作業設定動態屬性的可用性。 | Object | |
![]() |
避免處理事件流程中,目前節點以及任何後續節點中的任何事件偵聽程式。 | Event | |
![]() |
避免處理接續在事件流程中的目前節點之後,後續節點中的任何事件偵聽程式。 | Event | |
![]() |
傳回代表此物件的字串,根據地區特定慣例進行格式化。 | Object | |
[覆寫]
傳回包含 TouchEvent 物件所有屬性的字串。 | TouchEvent | ||
如果已經修改顯示清單,則指示 Flash Player 或 Adobe AIR 在此事件處理完畢後再顯示。 | TouchEvent | ||
![]() |
會傳回指定之物件的基本值。 | Object | |
| 常數 | 定義自 | ||
|---|---|---|---|
| PROXIMITY_BEGIN : String = "proximityBegin" [靜態]
定義 PROXIMITY_BEGIN 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| PROXIMITY_END : String = "proximityEnd" [靜態]
定義 PROXIMITY_END 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| PROXIMITY_MOVE : String = "proximityMove" [靜態]
定義 PROXIMITY_MOVE 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| PROXIMITY_OUT : String = "proximityOut" [靜態]
定義 PROXIMITY_OUT 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| PROXIMITY_OVER : String = "proximityOver" [靜態]
定義 PROXIMITY_OVER 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| PROXIMITY_ROLL_OUT : String = "proximityRollOut" [靜態]
定義 PROXIMITY_ROLL_OUT 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| PROXIMITY_ROLL_OVER : String = "proximityRollOver" [靜態]
定義 PROXIMITY_ROLL_OVER 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| TOUCH_BEGIN : String = "touchBegin" [靜態]
定義 TOUCH_BEGIN 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| TOUCH_END : String = "touchEnd" [靜態]
定義 TOUCH_END 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| TOUCH_MOVE : String = "touchMove" [靜態]
定義 TOUCH_MOVE 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| TOUCH_OUT : String = "touchOut" [靜態]
定義 TOUCH_OUT 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| TOUCH_OVER : String = "touchOver" [靜態]
定義 TOUCH_OVER 觸控事件物件的 typr 屬性值。 | TouchEvent | ||
| TOUCH_ROLL_OUT : String = "touchRollOut" [靜態]
定義 TOUCH_ROLL_OUT 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| TOUCH_ROLL_OVER : String = "touchRollOver" [靜態]
定義 TOUCH_ROLL_OVER 觸控事件物件的 type 屬性值。 | TouchEvent | ||
| TOUCH_TAP : String = "touchTap" [靜態]
定義 TOUCH_TAP 觸控事件物件的 type 屬性值。 | TouchEvent | ||
altKey | 屬性 |
commandKey | 屬性 |
controlKey | 屬性 |
ctrlKey | 屬性 |
isPrimaryTouchPoint | 屬性 |
isRelatedObjectInaccessible | 屬性 |
isRelatedObjectInaccessible:Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
如果是 true,則 relatedObject 屬性會因為安全執行程序的因素而設定為 null。如果 relatedObject 的名目值是另一個安全執行程序中 DisplayObject 的參考,則 relatedObject 會設定為 null,除非跨越安全執行程序邊界的兩個方向都有權限。建立權限的方法包括:從 SWF 檔呼叫 Security.allowDomain()、提供來自影像檔伺服器的原則檔案,以及於載入影像時設定 LoaderContext.checkPolicyFile 屬性。
實作
public function get isRelatedObjectInaccessible():Boolean public function set isRelatedObjectInaccessible(value:Boolean):void相關 API 元素
isTouchPointCanceled | 屬性 |
localX | 屬性 |
localY | 屬性 |
pressure | 屬性 |
relatedObject | 屬性 |
relatedObject:InteractiveObject| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
與事件相關的顯示清單物件的參照。 例如,當發生 touchOut 事件時,relatedObject 代表指向裝置現在指向的顯示清單物件。這個屬性套用到 touchOut、touchOver、touchRollOut 與 touchRollOver 事件。
在下列兩種情況下,這個屬性的值可能是 null:沒有相關物件,或是有相關物件但它位在您無法存取的安全執行程序中。使用 isRelatedObjectInaccessible() 屬性可判斷哪個原因適用於此情況。
實作
public function get relatedObject():InteractiveObject public function set relatedObject(value:InteractiveObject):void相關 API 元素
shiftKey | 屬性 |
sizeX | 屬性 |
sizeY | 屬性 |
stageX | 屬性 |
stageY | 屬性 |
timestamp | 屬性 |
touchIntent | 屬性 |
touchIntent:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
報告觸控是否由觸控筆的主要端點或橡皮擦端點所產生。
如果觸控事件是由手指或其它非觸控筆輸入方法所產生,或者用於高頻率動作追蹤的觸控筆不受支援,這個屬性就會回報值:TouchEventIntent.UNKNOWN。
TouchEventIntent 類別會定義常數,做為這個屬性的可能值,其中包括:
- TouchEventIntent.ERASER
- TouchEventIntent.PEN
- TouchEventIntent.UNKNOWN
實作
public function get touchIntent():String public function set touchIntent(value:String):void相關 API 元素
touchPointID | 屬性 |
touchPointID:int| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
指派至觸控點的唯一識別碼 (作為 int)。
實作
public function get touchPointID():int public function set touchPointID(value:int):void範例 ( 如何使用本範例 )
touchMoveID,以測試正確的 touchPointID 值,再回應觸控移動事件。否則,其他觸控輸入也會觸發事件處理常式。請注意,移動與結束階段的偵聽程式會在舞台上,而不是在顯示物件上。萬一使用者的觸控移出顯示物件界限,舞台會偵聽移動或結束階段。
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;
}
TouchEvent | () | 建構函式 |
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)| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
建立包含關於觸控事件資訊的 Event 物件。Event 物件會當做參數傳遞至事件偵聽程式。
參數type:String — 事件類型。可能的值為: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 和 TouchEvent.TOUCH_TAP。
| |
bubbles:Boolean (default = true) — 判斷事件物件是否參與事件流程的反昇階段。
| |
cancelable:Boolean (default = false) — 判斷是否可以取消 Event 物件。
| |
touchPointID:int (default = 0) — 指派至觸控點的唯一識別碼 (作為 int)。
| |
isPrimaryTouchPoint:Boolean (default = false) — 指定第一個接觸點是否對應到滑鼠事件。
| |
localX:Number (default = NaN) — 相對於包含的 sprite,事件發生的水平座標。
| |
localY:Number (default = NaN) — 相對於包含的 sprite,事件發生的垂直座標。
| |
sizeX:Number (default = NaN) — 接觸區域寬度。
| |
sizeY:Number (default = NaN) — 接觸區域高度。
| |
pressure:Number (default = NaN) — 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。
| |
relatedObject:InteractiveObject (default = null) — 受到事件影響的互補 InteractiveObject 實體。例如,當發生 touchOut 事件時,relatedObject 代表指向裝置現在指向的顯示清單物件。
| |
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 內容設定此參數。
| |
timestamp:Number (default = NaN) — (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。
| |
touchIntent:String (default = NaN) — (僅限 AIR) TouchEventIntent 類別的值。
| |
samples:ByteArray (default = null) — (僅限 AIR) ByteArray 物件,包含自 (按順序) 最後一個觸控或鄰近事件以來所記錄,每個中繼樣本的位置和壓力讀數。
| |
isTouchPointCanceled:Boolean (default = false) — (僅限 AIR) 如果因遭拒絕的觸控類型而取消觸控事件則為 true。
|
clone | () | 方法 |
getSamples | () | 方法 |
public function getSamples(buffer:ByteArray, append:Boolean = false):uint| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
請使用高頻率的資料點,為多點觸控事件更新指定的 ByteArray 物件。
buffer 參數所參考的 ByteArray 物件,會以這個及上一個觸控事件之間中繼資料點的值進行更新。每個樣本都會加入三個浮點值:x 座標、y 座標及壓力值。舞台座標中已回報位置值。壓力會回報為介於 0 和 1 之間的值。每隔一段固定時間都會記錄樣本。實際的頻率取決於裝置硬體和硬體驅動程式。一般取樣頻率大約為 133 Hz。請注意,觸控事件不會按確切的間隔傳送。因此,類似事件的緩衝區可能包含一些不同的樣本。緩衝區中的最後一個樣本,具有與這個觸控事件物件的 stageX、stageY 和 pressure 屬性相同的資料。
取樣緩衝區包含在針對 proximityMove 和 touchMove 事件傳送的事件物件。
參數
buffer:ByteArray — 接收取樣資料的 ByteArray 物件。
| |
append:Boolean (default = false) — 當 true 時,會從陣列的目前 position 屬性開始,將樣本加入 buffer 位元組陣列中。使用預設值 false 時,則會在加入樣本之前捨棄緩衝區物件中的現有資料。
|
uint — uint 是指加入到緩衝區的樣本數目。每個樣本包含三個浮點數。
|
相關 API 元素
範例 ( 如何使用本範例 )
function touchMoveHandler( event:TouchEvent ):void
{
if( (event.type == TouchEvent.TOUCH_MOVE ||
event.type == TouchEvent.PROXIMITY_MOVE) &&
event.touchEventIntent != TouchEventIntent.UNKNOWN )
{
var samples:ByteArray = new ByteArray();
event.getSamples( samples, true );
samples.position = 0; // rewind to beginning of array before reading
var xCoord:Number, yCoord:Number, pressure:Number;
while( samples.bytesAvailable > 0 )
{
xCoord = samples.readFloat();
yCoord = samples.readFloat();
pressure = samples.readFloat();
//do something with the sample data
}
}
}
var samples:ByteArray = new ByteArray();
function touchMoveHandler( event:TouchEvent ):void
{
if( (event.type == TouchEvent.TOUCH_MOVE ||
event.type == TouchEvent.PROXIMITY_MOVE) &&
event.touchEventIntent != TouchEventIntent.UNKNOWN )
{
var sampleCount:uint = event.getSamples( samples, true );
var xCoord:Number, yCoord:Number, pressure:Number;
for( var i:int; i < sampleCount; i++ )
{
xCoord = samples.readFloat();
yCoord = samples.readFloat();
pressure = samples.readFloat();
//do something with the sample data
}
}
}
isToolButtonDown | () | 方法 |
toString | () | 方法 |
updateAfterEvent | () | 方法 |
public function updateAfterEvent():void| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
如果已經修改顯示清單,則指示 Flash Player 或 Adobe AIR 在此事件處理完畢後再顯示。
PROXIMITY_BEGIN | 常數 |
public static const PROXIMITY_BEGIN:String = "proximityBegin"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
定義 PROXIMITY_BEGIN 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
timestamp | (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。 |
touchIntent | (僅限 AIR) TouchEventIntent 類別的值。 |
isTouchPointCanceled | (僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true。 |
相關 API 元素
PROXIMITY_END | 常數 |
public static const PROXIMITY_END:String = "proximityEnd"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
定義 PROXIMITY_END 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
timestamp | (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。 |
touchIntent | (僅限 AIR) TouchEventIntent 類別的值。 |
isTouchPointCanceled | (僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true。 |
相關 API 元素
PROXIMITY_MOVE | 常數 |
public static const PROXIMITY_MOVE:String = "proximityMove"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
定義 PROXIMITY_MOVE 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
timestamp | (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。 |
touchIntent | (僅限 AIR) TouchEventIntent 類別的值。 |
isTouchPointCanceled | (僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true。 |
相關 API 元素
PROXIMITY_OUT | 常數 |
public static const PROXIMITY_OUT:String = "proximityOut"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
定義 PROXIMITY_OUT 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
timestamp | (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。 |
touchIntent | (僅限 AIR) TouchEventIntent 類別的值。 |
isTouchPointCanceled | (僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true。 |
相關 API 元素
PROXIMITY_OVER | 常數 |
public static const PROXIMITY_OVER:String = "proximityOver"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
定義 PROXIMITY_OVER 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
timestamp | (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。 |
touchIntent | (僅限 AIR) TouchEventIntent 類別的值。 |
isTouchPointCanceled | (僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true。 |
相關 API 元素
PROXIMITY_ROLL_OUT | 常數 |
public static const PROXIMITY_ROLL_OUT:String = "proximityRollOut"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
定義 PROXIMITY_ROLL_OUT 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
timestamp | (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。 |
touchIntent | (僅限 AIR) TouchEventIntent 類別的值。 |
isTouchPointCanceled | (僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true。 |
相關 API 元素
PROXIMITY_ROLL_OVER | 常數 |
public static const PROXIMITY_ROLL_OVER:String = "proximityRollOver"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 3 |
定義 PROXIMITY_ROLL_OVER 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
timestamp | (僅限 AIR) 相對於應用程式開始時間的事件時間戳記 (毫秒)。 |
touchIntent | (僅限 AIR) TouchEventIntent 類別的值。 |
isTouchPointCanceled | (僅限 AIR) 如果因裝置的觸控拒絕邏輯而取消觸控事件則為 true。 |
相關 API 元素
TOUCH_BEGIN | 常數 |
public static const TOUCH_BEGIN:String = "touchBegin"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定義 TOUCH_BEGIN 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
相關 API 元素
TOUCH_END | 常數 |
public static const TOUCH_END:String = "touchEnd"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定義 TOUCH_END 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
相關 API 元素
TOUCH_MOVE | 常數 |
public static const TOUCH_MOVE:String = "touchMove"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定義 TOUCH_MOVE 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
相關 API 元素
TOUCH_OUT | 常數 |
public static const TOUCH_OUT:String = "touchOut"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定義 TOUCH_OUT 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
相關 API 元素
TOUCH_OVER | 常數 |
public static const TOUCH_OVER:String = "touchOver"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定義 TOUCH_OVER 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
相關 API 元素
TOUCH_ROLL_OUT | 常數 |
public static const TOUCH_ROLL_OUT:String = "touchRollOut"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定義 TOUCH_ROLL_OUT 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
相關 API 元素
TOUCH_ROLL_OVER | 常數 |
public static const TOUCH_ROLL_OVER:String = "touchRollOver"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定義 TOUCH_ROLL_OVER 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
相關 API 元素
TOUCH_TAP | 常數 |
public static const TOUCH_TAP:String = "touchTap"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定義 TOUCH_TAP 觸控事件物件的 type 屬性值。
傳送的 TouchEvent 物件有下列屬性:
| 屬性 | 值 |
|---|---|
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 | 事件流程中的目前階段。 |
isRelatedObjectInaccessible | 如果因為安全執行程序規則,relatedObject 屬性設定為 null,則為 true。 |
localX | 相對於包含的 sprite,事件發生的水平座標。 |
localY | 相對於包含的 sprite,事件發生的垂直座標。 |
pressure | 介於 0.0 和 1.0 之間的值,表示與裝置之間的接觸力道。如果裝置不支援偵測壓力,值為 1.0。 |
relatedObject | 與事件相關的顯示清單物件的參照。 |
shiftKey | 如果 Shift 鍵為作用中,則為 true;若已停用,則為 false。 |
sizeX | 接觸區域寬度。 |
sizeY | 接觸區域高度。 |
stageX | 在全域舞台座標上,事件發生的水平座標。 |
stageY | 在全域舞台座標上,事件發生的垂直座標。 |
target | 位於觸控裝置下方的 InteractiveObject 實體。target 不會永遠都是顯示清單中註冊事件偵聽程式的物件。 請使用 currentTarget 屬性,存取目前正在處理該事件之顯示清單中的物件。 |
touchPointID | 指派至觸控點的唯一識別碼 (作為 int)。 |
相關 API 元素
範例 ( 如何使用本範例 )
Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;
var mySprite:Sprite = new Sprite();
var myTextField:TextField = new TextField();
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);
mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);
function taphandler(e:TouchEvent): void {
myTextField.text = "I've been tapped";
myTextField.y = 50;
addChild(myTextField);
}
TOUCH_BEGIN、TOUCH_MOVE 以及 TOUCH_END 事件的事件處理。當接觸點在螢幕上移動 (onTouchMove) 時,以舞台為基準的 x 座標會記錄至輸出中。對於 onTouchBegin 函數中的 Sprite.startTouchDrag 參數,touchPointID 的值是指定給事件物件的值。邊界參數是一個矩形,定義父顯示物件的邊緣 ( bg 是一個內含 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");
}
Multitouch.maxTouchPoints 和觸控事件的 touchPointID 屬性。這個範例來自 Christian Cantrell,而且在您的快速入門中提供詳細的說明: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, 03:47 PM Z
隱藏繼承公用屬性
顯示繼承公用屬性