InteractiveObject  - AS3

對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。

相關 API 元素

指定與此物件有關聯的快顯選單。

對於在 Flash Player 中執行的內容，此屬性為 ContextMenu 物件。在 AIR 執行階段中，ContextMenu 類別會擴充 NativeMenu 類別，不過 Flash Player 只支援 ContextMenu 類別而非 NativeMenu 類別。

注意：TextField 物件紿終在快顯選單中包含剪貼簿選單。剪貼簿選單包含「剪下」、「複製」、「貼上」、「清除」以及「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。

var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
 
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
 
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
 
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    spr.graphics.clear();
    spr.graphics.beginFill(0xFF0000);
    spr.graphics.drawRect(0, 0, 120, 90);
    spr.graphics.endFill();
}

指定物件是否接收 doubleClick 事件。 預設值為 false，也就是說，InteractiveObject 依預設無法接收 doubleClick 事件。 如果將 doubleClickEnabled 屬性設為 true，則實體會接收到其範圍內的 doubleClick 事件。 InteractiveObject 實體的 mouseEnabled 屬性必須同時設為 true，這樣物件才能接收 doubleClick 事件。

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來加入 doubleClick 事件所需的事件偵聽程式。

相關 API 元素

會指定這個物件是否會顯示焦點矩形。 它可以接受下列三個值中的其中一個：true、false 或 null。true 和 false 值會如預期方式運作，指定是否顯示焦點矩形。null 值表示此物件會遵循舞台的 stageFocusRect 屬性。

指定此物件是否接收滑鼠或其他使用者輸入及訊息。預設值為 true，也就是說，任何位於顯示清單上的 InteractiveObject 實體，依預設都會接收滑鼠事件或其他使用者輸入事件。如果 mouseEnabled 設定成 false，則此實體不會接收任何滑鼠事件 (或其他使用者輸入事件，例如鍵盤事件)。在顯示清單上，此實體的任何子系都不會受到影響。 若要變更顯示清單上某個物件的所有子系之 mouseEnabled 行為指令，請使用 flash.display.DisplayObjectContainer.mouseChildren。

設定這個屬性不會傳送任何事件。 您必須使用 addEventListener() 方法來建立互動式功能。

相關 API 元素

指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。

根據預設，此值為 false，而將焦點放在 InteractiveObject 實體上並不會升起軟體鍵盤。如果將 needsSoftKeyboard 屬性設定為 true，則當 InteractiveObject 實體準備好接受使用者輸入時，執行階段便會升起軟體鍵盤。InteractiveObject 實體會在以程式設計方式呼叫以設定 Stage focus 屬性或使用者互動 (例如「輕點」) 之後準備好接受使用者輸入。如果用戶端系統可以使用硬體鍵盤，或者不支援虛擬鍵盤，則不會升起軟體鍵盤。

在升起和降下隱藏軟體鍵盤時，InteractiveObject 實體會傳送 softKeyboardActivating、softKeyboardActivate 及 softKeyboardDeactivate 事件。

注意：iOS 上的 AIR 應用程式中不支援此屬性。

相關 API 元素

控制軟體鍵盤的外觀。

具備軟體鍵盤的裝置可以自訂鍵盤按鍵，以符合所需的輸入類型。例如，如果需要數值輸入，裝置可以使用 SoftKeyboardType.NUMBER，只顯示軟體鍵盤上的數字。有效值定義為 SoftKeyboardType 類別的常數：

• "default"
• "punctuation"
• "url"
• "number"
• "contact"
• "email"
• "phone"
• "decimalpad"

這些值都是提示，可協助裝置顯示目前操作適用的最佳鍵盤。

預設值為 SoftKeyboardType.DEFAULT。

相關 API 元素

定義顯示軟體鍵盤時，應保留於螢幕上的區域 (iOS 未提供)。

如果此 InteractiveObject 的 needsSoftKeyboard 屬性為 true，則執行階段會視需要調整顯示，讓使用者在輸入資料時仍看得到物件。執行階段通常會使用從 DisplayObject.getBounds() 方法取得的物件邊界。您可以使用此 softKeyboardInputAreaOfInterest 屬性來指定不同的區域。

在舞台座標中指定 softKeyboardInputAreaOfInterest。

注意：在 Android 中，softKeyboardInputAreaOfInterest 不適用於橫向模式。

注意：iOS 不支援 softKeyboardInputAreaOfInterest。

相關 API 元素

會指定這個物件是否在停駐點順序中。 如果此物件在定位停駐點順序中，則其數值為 true，否則為 false。 根據預設，除了下列情況以外，這個值都為 false：

• 對於 SimpleButton 物件，這個值為 true。
• 對於具有 type = "input" 的 TextField 物件，這個值為 true。
• 對於 Sprite 物件或具有 buttonMode = true 的 MovieClip 物件，這個值為 true。

會指定 SWF 檔中的物件停駐點順序。 tabIndex 屬性預設為 -1，也就是說該物件沒有設定任何定位停駐點索引。

如果目前該 SWF 檔所顯示的任何物件含有 tabIndex 屬性，自動定位停駐點順序便會停用，而定位停駐點的順序會從物件在 SWF 檔中的 tabIndex 屬性開始計算。 自訂定位停駐點順序只會包含具有 tabIndex 屬性的物件。

tabIndex 屬性可以是非負值的整數。 物件是根據它們的 tabIndex 屬性，依遞增順序排列。 tabIndex 值為 1 的物件會排在 tabIndex 值為 2 的物件前面。 請勿對多個物件使用相同的 tabIndex 值。

由 tabIndex 屬性所定義的自訂定位停駐點順序是「平面」。 也就是說，SWF 檔中物件的階層架構關係是被忽略的。 該 SWF 檔中具有 tabIndex 屬性的所有物件都是依照定位停駐點順序放置的；這個定位停駐點順序是由 tabIndex 值的順序來決定。

注意：若要為 TLFTextField 實體設定停駐點順序，請將 TLFTextField 的顯示物件子系轉換為 InteractiveObject，然後設定 tabIndex 屬性。例如：

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

呼叫 new InteractiveObject() 建構函式會擲出 ArgumentError 例外。 然而，您可以呼叫下列 InteractiveObject 子類別的建構函式：

• new SimpleButton()
• new TextField()
• new Loader()
• new Sprite()
• new MovieClip()

升起顯示虛擬鍵盤。

呼叫此方法，會將焦點放在 InteractiveObject 實體上，並視需要升起軟體鍵盤。needsSoftKeyboard 也必須為 true。如果可以使用硬體鍵盤，或者用戶端系統不支援虛擬鍵盤，則不會升起鍵盤。

注意：iOS 上的 AIR 應用程式中不支援此方法。

相關 API 元素

當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField，此事件的預設行為指令就是刪除該文字欄位中目前選取的任何文字。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。 若要讓按下事件發生，該事件必須永遠按照此事件系列的發生順序： mouseDown 事件，然後才是 mouseUp。 這兩個事件的目標物件必須是完全相同的，否則就不會發生 click 事件。 不管何時，任何數量的其它滑鼠事件都可以在 mouseDown 或 mouseUp 事件之間發生；而 click 事件則是不管何時都會發生。

這個事件具有下列屬性：

當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。

這個事件具有下列屬性：

相關 API 元素

當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField，此事件的預設行為指令就是將該文字欄位中目前選取的任何文字複製到剪貼簿中。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField，此事件的預設行為指令就是剪下該文字欄位中目前選取的任何文字並貼入剪貼簿。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下，當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。 若要讓 doubleClick 事件發生，該事件必須緊跟著下列事件系列：mouseDown , mouseUp , click , mouseDown , mouseUp。所有這些事件都必須與 doubleClick 事件共用相同目標。 第二次的按下動作 (由第二個 mouseDown 與 mouseUp 事件所代表)，必須在 click 事件之後的某段特定時間內發生。 此段特定時間的可允許長度會依作業系統不同而改變，您也可以常常加以設定改變。 如果目標是可選取的文字欄位，則在預設的行為指令下會選取指標下的文字。 如果目標 InteractiveObject 沒有將自己的 doubleClickEnabled 旗標設為 true，就會接收兩個 click 事件。

doubleClickEnabled 屬性預設為 false。

TextField 物件之按兩下按鍵的文字選取行為與 doubleClick 事件不相關。 請使用 TextField.doubleClickEnabled 來控制 TextField 選取範圍。

這個事件具有下列屬性：

相關 API 元素

當顯示物件取得焦點「之後」傳送。 當使用者以指向裝置或鍵盤瀏覽來反白標示物件時，就會發生這個情況。 成為此類焦點的接收端物件我們稱為此事件的目標物件，而因為此變更而失去焦點的相對應 InteractiveObject 實體我們稱為相關物件。 對相關物件的參照會儲存在接收端物件的 relatedObject 屬性中。 shiftKey 屬性未被使用。 此事件會在先前物件的 focusOut 事件傳送之前發生。

這個事件具有下列屬性：

當顯示物件失去焦點「之後」傳送。 當使用者以指向裝置或鍵盤瀏覽來反白標示不同物件時，就會發生這個情況。 失去焦點的物件我們稱為此事件的目標物件，而成為焦點的相對應 InteractiveObject 實體我們稱為相關物件。 對相關物件的參照會儲存在目標物件的 relatedObject 屬性中。 shiftKey 屬性未被使用。 此事件會在相關物件傳送 focusIn 事件之前發生。

這個事件具有下列屬性：

當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選)，某些裝置可能也會將此接觸解譯為數個觸控事件的組合。

特別是，如果使用者用一個手指觸碰 InteractiveObject 上方，然後移開多個手指，則 InteractiveObject 實體可以傳送 touchBegin 事件和 touchEnd 事件 (在其他事件之中)，以及 gestureDirectionalTap 事件，或者如果目前環境支援，則傳送全部事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理，或者停用觸控事件，這樣只會傳送滑鼠事件)。如果您選擇處理 touchBegin 事件，則相同的事件處理常式會在觸控裝置上執行。不過，如果您選擇處理 gestureDirectionalTap 事件，就可以設計自己的事件處理常式，用於回應觸控環境的特殊需求，以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件，提供不同於觸控事件的回應給手勢事件。但是 flash.ui.Multitouch 類別會決定觸控事件或手勢事件是否會觸發。

處理事件物件的屬性時，請注意，localX 和 localY 屬性會設定成主要的接觸點 (以 Apple TV 為例，則為螢幕中央)。offsetX 和 offsetY 屬性會對應至手勢的方向。

注意：這個 API 僅支援單指方向點選。

傳送的 TransformGestureEvent 物件具有下列屬性：

相關 API 元素

當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方，以兩支手指按下後鬆開)。某些裝置可能會將這種接觸解譯為 doubleClick 事件。

特別是，如果使用者在 InteractiveObject 上方用兩根手指點一下，則 InteractiveObject 實體可以傳送 doubleClick 事件或 gestureTwoFingerTap 事件，或者如果目前環境支援，則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理，或者停用觸控事件，這樣只會傳送滑鼠事件)。如果您選擇處理 doubleClick 事件，則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過，如果您選擇處理 gestureTwoFingerTap 事件，就可以設計自己的事件處理常式，用於回應觸控環境的特殊需求，以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件，提供不同於滑鼠事件的回應給觸控事件。

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

相關 API 元素

當使用者在觸控裝置上，將接觸點移動到 InteractiveObject 實體上方後傳送 (例如，在行動電話或平板電腦觸控螢幕的顯示物件上，由左向右移動手指)。某些裝置可能會將這種接觸解譯為 mouseOver 事件和 touchOver 事件。

特別是，如果使用者將手指移至 InteractiveObject 上方，則 InteractiveObject 實體會傳送 mouseOver 事件、 touchOver 事件或 gesturePan 事件，或者如果目前環境支援，則傳送所有事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理，或者停用觸控事件，這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件，則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過，如果您選擇處理 gesturePan 事件，就可以設計自己的事件處理常式，用於回應觸控環境的特殊需求，以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件，提供不同於滑鼠事件的回應給觸控事件。

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

傳送的 TransformGestureEvent 物件具有下列屬性：

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPan(evt:TransformGestureEvent):void {

    evt.target.localX++;

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

相關 API 元素

當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上旋轉)。兩根手指轉動是常用的旋轉手勢，不過每一個裝置和作業系統各自有表示旋轉的規定。某些裝置可能也會將這種接觸解譯成多個滑鼠事件的組合。

特別是，如果使用者將手指移至 InteractiveObject 上方，則除了 gestureRotate 事件外，InteractiveObject 實體可以傳送一個 mouseOver 事件以及一個 click 事件 (在其他事件之中)，或者如果目前環境支援，則傳送全部事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理，或者停用觸控事件，這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件，則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過，如果您選擇處理 gestureRotate 事件，就可以設計自己的事件處理常式，用於回應觸控環境的特殊需求，以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件，提供不同於滑鼠事件的回應給觸控事件。

處理事件物件的屬性時，請注意 localX 和 localY 屬性會設定成主要的接觸點。offsetX 和 offsetY 屬性是完成旋轉手勢地點與接觸點的距離。

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

在這個事件期間，rotation 屬性會包含旋轉角度。旋轉值如下所示：

• 0 到 180 度代表順時針方向
• - 180 到 0 度代表逆時針方向

傳送的 TransformGestureEvent 物件具有下列屬性：

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onRotate(evt:TransformGestureEvent):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";
    }
}

相關 API 元素

當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如，三指併在一起觸碰行動電話或平板電腦的觸控螢幕，然後在顯示物件上快速平行移動手指)。平行移動多個手指是常見的揮動手勢，不過每一個裝置和作業系統對於揮動這個動作有自己的規定。某些裝置可能也會將這種接觸解譯成多個滑鼠事件的組合。

特別是，如果使用者將一個手指移至 InteractiveObject 上方，然後同時移動多個手指，則除了 gestureSwipe 事件外，InteractiveObject 實體可以傳送一個 rollOver 事件以及一個 rollOut 事件 (在其他事件之中)，或者如果目前環境支援，則傳送全部事件。選擇想要使用的使用者互動處理方式。如果您選擇處理 rollOver 事件，則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過，如果您選擇處理 gestureSwipe 事件，就可以設計自己的事件處理常式，藉此回應觸控環境的特殊需求，並提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件，提供不同於滑鼠事件的回應給觸控事件。

處理事件物件的屬性時，請注意 localX 和 localY 屬性會設定成主要的接觸點。offsetX 和 offsetY 屬性是完成揮動手勢之地點與接觸點之間的距離。

注意：雖然部分使用 Mac OS 作業系統的裝置可以解譯四指揮動，但這個 API 只支援三指揮動。

傳送的 TransformGestureEvent 物件具有下列屬性：

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onSwipe(evt:TransformGestureEvent):void {

    if (evt.offsetX == 1 ) {
    myTextField.text = "right";
    }
    if (evt.offsetY == -1) {
    myTextField.text = "up";
    }
    myTextField.text = evt.phase;

}

相關 API 元素

當使用者與 InteractiveObject 實體建立接觸點，然後在觸控裝置上點一下後送出 (例如，將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單，然後其中一根手點一下，選取選單項目)。某些裝置可能也會將這種接觸解譯成多個滑鼠事件的組合。

特別是，如果使用者將手指移至 InteractiveObject 上方，然後再點一下，則除了 gesturePressAndTap 事件外，InteractiveObject 實體可以傳送一個 mouseOver 事件以及一個 click 事件 (在其他事件之中)，或者如果目前環境支援，則傳送全部事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理，或者停用觸控事件，這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件，則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過，如果您選擇處理 gesturePressAndTap 事件，就可以設計自己的事件處理常式，用於回應觸控環境的特殊需求，以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件，提供不同於滑鼠事件的回應給觸控事件。

處理事件物件的屬性時，請注意，localX 和 localY 屬性會設定成主要的接觸點 (「推」的動作)。offsetX 和 offsetY 屬性是與第二個接觸點 (「點一下」) 的距離。

相關 API 元素

當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上快速張開)。手指分開是常用的縮放手勢，不過每一個裝置和作業系統各有自己表示縮放的規定。某些裝置可能也會將這種接觸解譯成多個滑鼠事件的組合。

特別是，如果使用者將手指移至 InteractiveObject 上方，然後分開手指，則除了 gestureZoom 事件外，InteractiveObject 實體可以傳送一個 mouseOver 事件以及一個 click 事件 (在其他事件之中)，或者如果目前環境支援，則傳送全部事件。選擇想要使用的使用者互動處理方式。使用 flash.ui.Multitouch 類別來管理觸控事件 (啟用觸控手勢事件處理、簡單觸控點事件處理，或者停用觸控事件，這樣只會傳送滑鼠事件)。如果您選擇處理 mouseOver 事件，則相同的事件處理常式會在觸控裝置和具備滑鼠功能的裝置上執行。不過，如果您選擇處理 gestureZoom 事件，就可以設計自己的事件處理常式，用於回應觸控環境的特殊需求，以及提供使用者更豐富的觸控體驗。您也可以分開處理這兩個事件，提供不同於滑鼠事件的回應給觸控事件。

處理事件物件的屬性時，請注意 localX 和 localY 屬性會設定成主要的接觸點。offsetX 和 offsetY 屬性是完成縮放手勢地點與接觸點的距離。

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

傳送的 TransformGestureEvent 物件具有下列屬性：

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onZoom(evt:TransformGestureEvent):void {

    evt.target.scaleX++;

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

相關 API 元素

這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。

會當使用者按下按鍵時傳送。 按鍵與特殊字元之間的對應會依裝置與作業系統的不同而改變。 此事件類型會在發生此類對應後，但在輸入法編輯器 (IME) 處理階段前產生。 由於標準的 QWERTY 鍵盤在按鍵配置上不利於類似中文表意文字的輸入，人們便使用 IME 來克服這項限制。 此事件會在 keyUp 事件之前發生。

在 AIR 中，取消此事件會禁止在文字欄位中輸入字元。

這個事件具有下列屬性：

當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。 此事件的預設行為指令就是變更焦點並傳送相對應的 focusIn 與 focusOut 事件。

此事件會傳送至目前成為焦點的物件。此事件的相關物件就是接收焦點的 InteractiveObject 實體 (如果您沒有改變預設行為指令的話)。 您可以呼叫已經正確註冊為目標物件之事件偵聽程式的 preventDefault() 方法來預防此項變更。 根據預設，焦點會變更，而且會傳送 focusIn 和 focusOut 事件。

這個事件具有下列屬性：

會當使用者放開按鍵時傳送。 按鍵與特殊字元之間的對應會依裝置與作業系統的不同而改變。 此事件類型會在發生此類對應後，但在輸入法編輯器 (IME) 處理階段前產生。 由於標準的 QWERTY 鍵盤在按鍵配置上不利於類似中文表意文字的輸入，人們便使用 IME 來克服這項限制。 此事件會在 keyDown 事件後發生，並且具有下列特徵：

這個事件具有下列屬性：

當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。若要讓 middleClick 事件發生，該事件必須永遠按照此事件系列的發生順序：middleMouseDown 事件，然後才是 middleMouseUp。這兩個事件的目標物件必須完全相同，否則就不會發生 middleClick 事件。不管何時，任何數量的其它滑鼠事件都可以在 middleMouseDown 或 middleMouseUp 事件之間發生；而 middleClick 事件則是不管何時都會發生。

這個事件具有下列屬性：

當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。

這個事件具有下列屬性：

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。

這個事件具有下列屬性：

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。如果目標是 SimpleButton 實體，則 SimpleButton 實體會在預設的行為指令下顯示 downState 顯示物件。 如果目標是可選取的文字欄位，則文字欄位會在預設的行為指令下開始選取範圍。

這個事件具有下列屬性：

會當使用者嘗試使用指向裝置變更焦點時傳送。 此事件的預設行為指令就是變更焦點並傳送相對應的 focusIn 與 focusOut 事件。

此事件會傳送至目前成為焦點的物件。此事件的相關物件就是接收焦點的 InteractiveObject 實體 (如果您沒有改變預設行為指令的話)。 您可以呼叫已經正確註冊為目標物件之事件偵聽程式的 preventDefault() 來預防此項變更。 shiftKey 屬性未被使用。 根據預設，焦點會變更，而且會傳送 focusIn 和 focusOut 事件。

這個事件具有下列屬性：

會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。 如果目標是使用者正在選取的文字欄位，在預設的行為指令下會更新選取範圍。

這個事件具有下列屬性：

會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 事件目標指的是先前位於指向裝置下方的物件。 relatedObject 指的是指標裝置的移動目標物件。 如果目標是 SimpleButton 實體，則按鈕會在預設的行為指令下顯示 upState 顯示物件。

每當滑鼠離開顯示物件容器的任何子物件區域時，都會傳送 mouseOut 事件，即使滑鼠仍然位於顯示物件容器的另一個子物件上方。 這樣的行為與 rollOut 事件的用途不同，後者是要為有子系的顯示物件容器簡化滑入行為的程式碼編寫工作。 當滑鼠離開顯示物件的區域或任何子系的區域，以移到其非子系物件時，顯示物件會傳送 rollOut 事件。rollOut 事件會沿著物件的上層鏈連續往上傳送，以物件為開頭，並以既不是 relatedObject 的根，也不是其祖系的最上層為結尾。

這個事件具有下列屬性：

會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 relatedObject 是先前位於指標裝置下方的物件。 如果目標是 SimpleButton 實體，則物件會依據滑鼠按鈕是否按下來決定要顯示 overState 或 upState 顯示物件 (預設的行為指令)。

每當滑鼠進入顯示物件容器的任何子物件區域時，都會傳送 mouseOver 事件，即使滑鼠已經移到顯示物件容器的另一個子物件上方。 這樣的行為與 rollOver 事件的用途不同，後者是要為有子系的顯示物件容器簡化滑開行為的程式碼編寫工作。 當滑鼠進入顯示物件的區域，或從其非子系物件進入其任何子系區域時，顯示物件會傳送 rollOver 事件。 rollOver 事件會連續傳送至物件之上層鏈下方，以不屬於 relatedObject 的根或祖系的最上層為開頭，並以物件做為結尾。

這個事件具有下列屬性：

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。如果目標是 SimpleButton 實體，則物件會顯示 upState 顯示物件。 如果目標是可選取的文字欄位，則文字欄位會在預設的行為指令下結束選取範圍。

這個事件具有下列屬性：

當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。如果目標是文字欄位，則文字會在預設的行為指令下捲動。只有 Microsoft Windows 作業系統才可使用。

這個事件具有下列屬性：

當使用者釋放手勢時，由拖曳初始程式 InteractiveObject 傳送。

此事件的 dropAction 屬性表示拖曳目標物件所設定的動作。值為「無」(DragActions.NONE) 表示已取消或不使用放下動作。

例如，若要透過從清單中移除項目 (在「移動」拖曳動作上) 或變更視覺屬性的方式，更新初始顯示物件的狀態，使用 nativeDragComplete 事件處理常式是非常便利的方式。

這個事件具有下列屬性：

已在目標 InteractiveObject 上放下拖曳的物件，而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時，由此目標 InteractiveObject 傳送。

您可以使用事件物件的 clipboard 屬性存取已放下的資料。

此事件的處理常式應該設定 DragManager.dropAction 屬性以提供回應給初始程式物件，告知要採取哪種拖曳動作。如果沒有設定任何值，DragManager 將會從允許的動作清單中選取預設值。

這個事件具有下列屬性：

當手勢進入 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。

您可以處理 nativeDragEnter 或 nativeDragOver 事件，允許顯示物件成為放下時的目標。

若要判斷所傳送的顯示物件是否能接受該放下的資料，請檢查此事件物件之 clipboard 屬性中資料是否適當，以及 allowedActions 屬性中所允許的拖曳動作。

這個事件具有下列屬性：

當手勢離開 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。

這個事件具有下列屬性：

當拖曳手勢還留在 InteractiveObject 的邊界內，由此 InteractiveObject 持續傳送。

只要移動滑鼠就會傳送 nativeDragOver 事件。在 Windows 和 Mac 上即使沒有移動滑鼠，若計時器間隔較短還是會傳送這些事件。

您可以處理 nativeDragOver 或 nativeDragEnter 事件，允許顯示物件成為放下時的目標。

若要判斷所傳送的顯示物件是否能接受該放下的資料，請檢查此事件物件之 clipboard 屬性中資料是否適當，以及 allowedActions 屬性中所允許的拖曳動作。

這個事件具有下列屬性：

在呼叫 DragManager.doDrag() 進行拖曳作業初期，由指定做為拖曳初始程式的 InteractiveObject 傳送。

這個事件具有下列屬性：

在呼叫 DragManager.doDrag() 進行拖曳作業期間，由指定做為拖曳初始程式的 InteractiveObject 傳送。

在 Linux 上不會傳送 nativeDragUpdate 事件。

這個事件具有下列屬性：

當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。此事件會傳送至目前成為焦點的物件。如果目前成為焦點的物件是 TextField，此事件的預設行為指令就是將剪貼簿的內容貼入該文字欄位的目前插入點，並取代該文字欄位中目前選取的任何文字。

這個事件具有下列屬性：

注意：TextField 物件不會傳送 clear、copy、cut、paste 或 selectAll 事件。TextField 物件一定會在快顯選單中加入「剪下」、「複製」、「貼上」、「清除」與「全選」命令。您無法將這些命令從 TextField 物件的快顯選單中移除。對於 TextField 物件，選擇這些命令 (或它們的鍵盤相對按鍵) 並不會產生 clear、copy、cut、paste 或 selectAll 事件。不過，其他延伸 InteractiveObject 類別的類別 (包括使用 Flash 文字引擎 (FTE) 建立的組件)，將會傳送這些事件以回應鍵盤快速鍵與快顯選單等使用者動作。

在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。

在使用者將觸控筆往下移至螢幕，在螢幕上到處移動，接著移開觸控筆時發生的一般事件序列為：

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

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

相關 API 元素

在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。

當觸控筆觸碰螢幕時，不會傳送 proximityEnd 事件。

在使用者將觸控筆往下移至螢幕，在螢幕上到處移動，接著移開觸控筆時發生的一般事件序列為：

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

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

相關 API 元素

在使用者將作用中觸控筆移到螢幕上方，而其餘仍在鄰近偵測邊框內時傳送。

在使用者將觸控筆往下移至螢幕，在螢幕上到處移動，接著移開觸控筆時發生的一般事件序列為：

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

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

相關 API 元素

在使用者將作用中觸控筆移出這個 InteractiveObject 之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

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

相關 API 元素

在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方，而其餘仍在螢幕的鄰近偵測邊框內時傳送。

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

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

相關 API 元素

在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。

事件目標指的是先前位於觸控筆下方的物件，或是該物件的父輩。relatedObject 指的是由觸控筆移動上方的目標物件。proximityRollOut 事件會連續傳送至物件之上層鏈上方，以物件為開頭，並以不屬於 relatedObject 的根或祖系的最上層為結尾。

proximityRollOut 事件的目的是要針對具有子系之顯示物件容器的滑入行為，簡化其編碼程序。當觸控筆離開顯示物件區域，包括其任何子系區域，並進入非屬其任一子系的物件時，顯示物件就會傳送 proximityRollOut 事件。此種行為與 proximityOut 事件的行為表現不同，後者會在每次滑鼠離開顯示物件容器之任一子物件區域時傳送，就算滑鼠仍舊停留在顯示物件容器之另一個子物件上方亦然。

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

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

相關 API 元素

在使用者透過這個 InteractiveObject，從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。

事件目標指的是觸控筆下方的物件，或是該物件的父輩。relatedObject 是先前位於觸控筆下方的物件。proximityRollOver 事件會連續傳送至物件之上層鏈下方，以不屬於 relatedObject 的根或祖系的最上層為開頭，並以物件做為結尾。

proximityRollOver 事件的目的是要針對具有子系之顯示物件容器的滑出行為，簡化其編碼程序。當觸控筆進入顯示物件上方的區域，或從其非子系物件進入其任何子系上方的區域時，顯示物件會傳送 proximityRollOver 事件。此種行為與 proximityOver 事件的行為表現不同，後者會在每次滑鼠進入顯示物件容器之任一子物件區域時傳送，就算滑鼠已經移動至顯示物件容器之另一個子物件上方亦然。

注意：如需環境相容性資訊，請參閱 Multitouch 類別。

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

相關 API 元素

當使用者第一次按下 InteractiveObject 實體上方的按鈕，然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。如果目標是 SimpleButton 實體，則物件會顯示 upState 顯示物件。 如果目標是可選取的文字欄位，則文字欄位會在預設的行為指令下結束選取範圍。

這個事件具有下列屬性：

當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。若要讓 rightClick 事件發生，該事件必須永遠按照此事件系列的發生順序：rightMouseDown 事件，然後才是 rightMouseUp。這兩個事件的目標物件必須完全相同，否則就不會發生 rightClick 事件。不管何時，任何數量的其它滑鼠事件都可以在 rightMouseDown 或 rightMouseUp 事件之間發生；而 rightClick 事件則是不管何時都會發生。

這個事件具有下列屬性：

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。

這個事件具有下列屬性：

當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。

這個事件具有下列屬性：

會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 事件目標指的是先前位於指向裝置下方的物件，或是該物件的父輩。 relatedObject 指的是指標裝置的移動目標物件。 rollOut 事件會連續傳送至物件之上層鏈上方，以物件為開頭，並以不屬於 relatedObject 的根或祖系的最上層為結尾。

rollOut 事件的目的是要針對具有子系之顯示物件容器的滑入行為，簡化其編碼程序。 當滑鼠離開顯示物件區域，或其任何子系區域，並進入非屬其任一子系的物件時，顯示物件就會傳送 rollOut 事件。 此種行為與 mouseOut 事件的行為表現不同，後者會在每次滑鼠離開顯示物件容器之任一子物件區域時傳送，就算滑鼠仍舊停留在顯示物件容器之另一個子物件上方亦然。

這個事件具有下列屬性：

會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 事件目標指的是指向裝置下方的物件，或是該物件的父輩。 relatedObject 是先前位於指標裝置下方的物件。 rollOver 事件會連續傳送至物件之上層鏈下方，以不屬於 relatedObject 的根或祖系的最上層為開頭，並以物件做為結尾。

rollOver 事件的目的是要針對具有子系之顯示物件容器的滑出行為，簡化其編碼程序。 當滑鼠進入顯示物件的區域，或從其非子系物件進入其任何子系區域時，顯示物件會傳送 rollOver 事件。 此種行為與 mouseOver 事件的行為表現不同，後者會在每次滑鼠進入顯示物件容器之任一子物件區域時傳送，就算滑鼠已經移動至顯示物件容器之另一個子物件上方亦然。

這個事件具有下列屬性：