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 指定启动此拖动操作的显示对象允许执行的操作的 NativeDragOption 对象。	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）。commandKey 属性的值将与 Mac 中 ctrlKey 属性的值相同。	MouseEvent
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		controlKey : Boolean 表示在 Mac 中是否已激活 Control 键，以及在 Windows 或 Linux 中是否已激活 Ctrl 键。	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

指定启动此拖动操作的显示对象允许执行的操作的 NativeDragOption 对象。

相关 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`) — 表示 Event 对象是否参与事件流的冒泡阶段。

	`cancelable:Boolean` (default = `true`) — 表示是否可以取消 Event 对象。

	`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`) — 表示是否已激活 Ctrl 键。

	`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 对象。即使在调度此事件的对象与启动器不在同一安全域中时也可以读取剪贴板。
`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