NativeDragEvent

套件	flash.events
類別	public class NativeDragEvent
繼承	NativeDragEvent MouseEvent Event Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

當拖放作業牽涉到互動式物件時，就會傳送原生拖曳事件。

起始物件會傳送：

nativeDragStart — 當拖曳作業開始時。
nativeDragUpdate — 當拖曳作業正在進行期間。
nativeDragComplete — 當使用者放下拖曳的項目時 (不管是否已接受放下的資料)。

起始物件是在對 NativeDragManager.doDrag() 的呼叫 (會開始拖曳作業) 中傳遞至 NativeDragManager 的互動式物件。

可能的目標互動式物件會傳送：

nativeDragEnter — 在物件的邊界內傳遞拖曳手勢時。
nativeDragOver — 當拖曳手勢持續留在物件的邊界內期間。
nativeDragExit — 當拖曳手勢離開物件的邊界時。
nativeDragDrop — 當使用者在物件上方放下拖曳的項目，而且此物件之前已呼叫 NativeDragManager.acceptDragDrop() 接受放下的資料時。

通常 nativeDragEnter 或 nativeDragOver 事件的處理常式在允許的拖曳動作進行時，會一併評估遭到拖曳的資料，以判斷互動式物件是否能夠接受放下的資料。若要指定互動式物件為合格的目標，此事件處理常式必須呼叫 NativeDragManager.acceptDrop() 函數，並傳入該物件的參考。如果使用者在指定的物件上方放開滑鼠按鈕，該物件就會成為放下目標並傳送 nativeDragDrop 事件。

任何 InteractiveObject 類型的物件都可以是拖曳初始程式或放下目標。

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		allowedActions : NativeDragOptions NativeDragOptions 物件，可指定起始此拖曳作業之顯示物件所允許的動作。	NativeDragEvent
		altKey : Boolean 指出 Alt 鍵為作用中 (true) 或停用 (false)。	MouseEvent
		bubbles : Boolean [唯讀] 指出事件是否為反昇事件。	Event
		buttonDown : Boolean 指出已按下主要滑鼠按鈕 (true) 或未按下 (false)。	MouseEvent
		cancelable : Boolean [唯讀] 指出是否可避免與事件相關聯的行為指令。	Event
		clickCount : int [唯讀] 指出此滑鼠按下事件是否為多次按下動作序列的一部分。	MouseEvent
		clipboard : Clipboard Clipboard 物件，其中包含此拖曳作業中的資料。	NativeDragEvent
		commandKey : Boolean 指出 Command 鍵是否已啟用 (僅限 Mac)。在 Mac 中，commandKey 屬性的值將與 ctrlKey 屬性的值相同。	MouseEvent
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		controlKey : Boolean 指出是否已啟用 Control 鍵 (在 Mac 中) 以及是否已啟用 Ctrl 鍵 (在 Windows 或 Linux 中)。	MouseEvent
		ctrlKey : Boolean 在 Windows 或 Linux 中，指出 Ctrl 鍵為作用中 (true) 或已停用 (false)。	MouseEvent
		currentTarget : Object [唯讀] 正主動使用事件偵聽程式處理 Event 物件的物件。	Event
		delta : int 指出當使用者滾動滑鼠滾輪時，每滾動一個單位 (一格) 所代表的捲動行數。	MouseEvent
		dropAction : String 目前的動作。	NativeDragEvent
		eventPhase : uint [唯讀] 事件流程中的目前階段。	Event
		isRelatedObjectInaccessible : Boolean 如果是 true，則 relatedObject 屬性會因為安全執行程序的因素而設定為 null。	MouseEvent
		localX : Number 滑鼠鎖定停用時，則為相對於包含的 Sprite，事件發生的水平座標。	MouseEvent
		localY : Number 滑鼠鎖定停用時，則為相對於包含的 Sprite，事件發生的垂直座標。	MouseEvent
		movementX : Number 滑鼠鎖定啟用時，則為自上次滑鼠事件以來滑鼠位置在 X 方向的變更。	MouseEvent
		movementY : Number 滑鼠鎖定啟用時，則為自上次滑鼠事件以來滑鼠位置在 Y 方向的變更。	MouseEvent
		relatedObject : InteractiveObject 與事件相關的顯示清單物件的參照。	MouseEvent
		shiftKey : Boolean 指出 Shift 鍵為作用中 (true) 或停用 (false)。	MouseEvent
		stageX : Number [唯讀] 在全域舞台座標上，事件發生的水平座標。	MouseEvent
		stageY : Number [唯讀] 在全域舞台座標上，事件發生的垂直座標。	MouseEvent
		target : Object [唯讀] 事件目標。	Event
		type : String [唯讀] 事件類型。	Event

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		NativeDragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, clipboard:Clipboard = null, allowedActions:NativeDragOptions = null, dropAction:String = null, controlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false) 使用與原生拖放事件相關的特定資訊來建立 Event 物件。	NativeDragEvent
		clone():Event [覆寫] 建立此 NativeDragEvent 物件的副本。	NativeDragEvent
		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 [覆寫] 將此 NativeDragEvent 物件的屬性格式化為字串。	NativeDragEvent
		updateAfterEvent():void 如果已經修改顯示清單，則指示 Flash Player 或 Adobe AIR 在此事件處理完畢後再顯示。	MouseEvent
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自
		NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [靜態] NativeDragEvent.NATIVE_DRAG_COMPLETE 會定義 nativeDragComplete 事件物件的 type 屬性值。	NativeDragEvent
		NATIVE_DRAG_DROP : String = "nativeDragDrop" [靜態] NativeDragEvent.NATIVE_DRAG_DROP 會定義 nativeDragDrop 事件物件的 type 屬性值。	NativeDragEvent
		NATIVE_DRAG_ENTER : String = "nativeDragEnter" [靜態] NativeDragEvent.NATIVE_DRAG_ENTER 會定義 nativeDragEnter 事件物件的 type 屬性值。	NativeDragEvent
		NATIVE_DRAG_EXIT : String = "nativeDragExit" [靜態] NativeDragEvent.NATIVE_DRAG_EXIT 會定義 nativeDragExit 事件物件的 type 屬性值。	NativeDragEvent
		NATIVE_DRAG_OVER : String = "nativeDragOver" [靜態] NativeDragEvent.NATIVE_DRAG_OVER 會定義 nativeDragOver 事件物件的 type 屬性值。	NativeDragEvent
		NATIVE_DRAG_START : String = "nativeDragStart" [靜態] NativeDragEvent.NATIVE_DRAG_START 會定義 nativeDragStart 事件物件的 type 屬性值。	NativeDragEvent
		NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [靜態] NativeDragEvent.NATIVE_DRAG_UPDATE 會定義 nativeDragUpdate 事件物件的 type 屬性值。	NativeDragEvent

屬性詳細資訊

allowedActions

屬性

public var allowedActions:NativeDragOptions

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

NativeDragOptions 物件，可指定起始此拖曳作業之顯示物件所允許的動作。

相關 API 元素

flash.desktop.NativeDragOptions

clipboard

屬性

public var clipboard:Clipboard

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

Clipboard 物件，其中包含此拖曳作業中的資料。

如果傳送此事件的物件與起始物件不在相同的安全性網域中，則只能在 nativeDragDrop 事件的處理常式中讀取此剪貼簿。

相關 API 元素

flash.desktop.Clipboard

dropAction

屬性

public var dropAction:String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

目前的動作。在 nativeDragComplete 事件中，dropAction 屬性會報告最終動作。

建構函式詳細資料

()

建構函式

public function NativeDragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, clipboard:Clipboard = null, allowedActions:NativeDragOptions = null, dropAction:String = null, controlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false)

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

使用與原生拖放事件相關的特定資訊來建立 Event 物件。

Event 物件會當做參數傳遞至事件偵聽程式。傳送原生拖曳事件並不會觸發相關聯的行為指令。

參數

	`type:String` — 事件類型。可能使用的值為：`NativeDragEvent.NATIVE_DRAG_START`、`NativeDragEvent.NATIVE_DRAG_UPDATE`、`NativeDragEvent.NATIVE_DRAG_ENTER`、`NativeDragEvent.NATIVE_DRAG_OVER`、`NativeDragEvent.NATIVE_DRAG_EXIT`、`NativeDragEvent.NATIVE_DRAG_DROP` 和 `NativeDragEvent.NATIVE_DRAG_COMPLETE`。

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

	`cancelable:Boolean` (default = `true`) — 指出是否可以取消事件物件。

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

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

	`relatedObject:InteractiveObject` (default = `null`) — 相關的互動式顯示物件。

	`clipboard:Clipboard` (default = `null`) — 包含要傳輸之資料的 Clipboard 物件。

	`allowedActions:NativeDragOptions` (default = `null`) — 定義允許之動作 (移動、複製或連結) 的 NativeDragOptions 物件。

	`dropAction:String` (default = `null`) — 目前的動作。

	`controlKey:Boolean` (default = `false`) — 指出是否已啟動 Control 鍵。

	`altKey:Boolean` (default = `false`) — 指出是否已啟動 Alt 鍵。

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

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

方法詳細資訊

clone

()

方法

override public function clone():Event

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

建立此 NativeDragEvent 物件的副本。

傳回值

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

toString

()

方法

override public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

將此 NativeDragEvent 物件的屬性格式化為字串。

此字串的格式如下：

[NativeDragEvent type=value bubbles=value cancelable=value ... commandKey=value]

傳回值

String — 此 NativeDragEvent 的屬性 (形式為字串)。

常數詳細資訊

NATIVE_DRAG_COMPLETE

常數

public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_COMPLETE 會定義 nativeDragComplete 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`allowedActions`	NativeDragOptions 物件，指定與此拖曳作業相關的動作。
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`clipboard`	Clipboard 物件，包含拖曳的資料。
`dropAction`	放下目標所選擇的動作 (如果沒有設定任何動作，則為 `none`)。

NATIVE_DRAG_DROP

常數

public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_DROP 會定義 nativeDragDrop 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`allowedActions`	NativeDragOptions 物件，指定與此拖曳作業相關的動作。
`bubbles`	`true`
`cancelable`	`true`；取消此事件將取消拖曳作業。
`clipboard`	Clipboard 物件，包含拖曳的資料。即使傳送此事件之物件所在的安全性網域與初始程式不同，也能讀取此 clipboard。
`dropAction`	放下目標所選擇的動作 (如果沒有設定任何動作，則為 `none`)。

NATIVE_DRAG_ENTER

常數

public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_ENTER 會定義 nativeDragEnter 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`allowedActions`	NativeDragOptions 物件，指定與此拖曳作業相關的動作。
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`clipboard`	Clipboard 物件，包含拖曳的資料。只有在傳送此事件的物件與初始程式位於相同的安全性網域中，才能讀取此剪貼簿。
`dropAction`	放下目標所選擇的動作 (如果沒有設定任何動作，則為 `none`)。

NATIVE_DRAG_EXIT

常數

public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_EXIT 會定義 nativeDragExit 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`allowedActions`	NativeDragOptions 物件，指定與此拖曳作業相關的動作。
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`clipboard`	Clipboard 物件，包含拖曳的資料。只有在傳送此事件的物件與初始程式位於相同的安全性網域中，才能讀取此剪貼簿。
`dropAction`	放下目標所選擇的動作 (如果沒有設定任何動作，則為 `none`)。

NATIVE_DRAG_OVER

常數

public static const NATIVE_DRAG_OVER:String = "nativeDragOver"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_OVER 會定義 nativeDragOver 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`allowedActions`	NativeDragOptions 物件，指定與此拖曳作業相關的動作。
`bubbles`	`true`
`cancelable`	`true`；取消此事件將取消拖曳作業。
`clipboard`	Clipboard 物件，包含拖曳的資料。只有在傳送此事件的物件與初始程式位於相同的安全性網域中，才能讀取此剪貼簿。
`dropAction`	放下目標所選擇的動作 (如果沒有設定任何動作，則為 `none`)。

NATIVE_DRAG_START

常數

public static const NATIVE_DRAG_START:String = "nativeDragStart"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_START 會定義 nativeDragStart 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`allowedActions`	NativeDragOptions 物件，指定與此拖曳作業相關的動作。
`bubbles`	`true`
`cancelable`	`true`；取消此事件將取消拖曳作業。
`clipboard`	Clipboard 物件，包含拖曳的資料。
`dropAction`	放下目標所選擇的動作 (如果沒有設定任何動作，則為 `none`)。

NATIVE_DRAG_UPDATE

常數

public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_UPDATE 會定義 nativeDragUpdate 事件物件的 type 屬性值。

這個事件具有下列屬性：

屬性	值
`allowedActions`	NativeDragOptions 物件，指定與此拖曳作業相關的動作。
`bubbles`	`true`
`cancelable`	`false`；沒有要取消的預設行為指令。
`clipboard`	Clipboard 物件，包含拖曳的資料。
`dropAction`	放下目標所選擇的動作 (如果沒有設定任何動作，則為 `none`)。

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

NativeDragEvent - AS3

類別 x

allowedActions

clipboard

dropAction