DragEvent

包	mx.events
类	public class DragEvent
继承	DragEvent MouseEvent Event Object
子类	InterDragManagerEvent

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

DragEvent 类代表作为拖放操作部分进行调度的事件对象。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		action : String 所需的操作。	DragEvent
		altKey : Boolean 表示 Alt 键是处于活动状态 (true) 还是非活动状态 (false)。	MouseEvent
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		buttonDown : Boolean 表示鼠标主按键是已按下 (true) 还是未按下 (false)。	MouseEvent
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		clickCount : int [只读] 表示鼠标按下事件是否为多击序列的一部分。	MouseEvent
		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
		draggedItem : Object 如果 dragInitiator 属性包含 IAutomationObject 对象，则此属性在鼠标光标附近包含子 IAutomationObject 对象。	DragEvent
		dragInitiator : IUIComponent 启动拖动的组件。	DragEvent
		dragSource : DragSource 包含正在拖动的数据的 DragSource 对象。	DragEvent
		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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		DragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, dragInitiator:IUIComponent = null, dragSource:DragSource = null, action:String = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false) 构造函数。	DragEvent
		clone():Event [覆盖] 创建 MouseEvent 对象的副本，并设置每个属性的值以匹配原始属性值。	MouseEvent
		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 [覆盖] 返回一个字符串，其中包含 MouseEvent 对象的所有属性。	MouseEvent
		updateAfterEvent():void 如果已修改显示列表，则将表示 Flash Player 或 Adobe AIR 在此事件处理完成后呈示结果。	MouseEvent
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		DRAG_COMPLETE : String = "dragComplete" [静态] DragEvent.DRAG_COMPLETE 常量可为 dragComplete 事件定义事件对象的 type 属性的值。	DragEvent
		DRAG_DROP : String = "dragDrop" [静态] DragEvent.DRAG_DROP 常量可为 dragDrop 事件定义事件对象的 type 属性的值。	DragEvent
		DRAG_ENTER : String = "dragEnter" [静态] DragEvent.DRAG_ENTER 常量可为 dragEnter 事件定义事件对象的 type 属性的值。	DragEvent
		DRAG_EXIT : String = "dragExit" [静态] DragEvent.DRAG_EXIT 常量可为 dragExit 事件定义事件对象的 type 属性的值。	DragEvent
		DRAG_OVER : String = "dragOver" [静态] DragEvent.DRAG_OVER 常量可为 dragOver 事件定义事件对象的 type 属性的值。	DragEvent
		DRAG_START : String = "dragStart" [静态] DragEvent.DRAG_START 常量可为 dragStart 事件定义事件对象的 type 属性的值。	DragEvent

属性详细信息

action

属性

public var action:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

所需的操作。DragManager.COPY、DragManager.LINK、DragManager.MOVE 或 DragManager.NONE 中的任意一项。

draggedItem

属性

public var draggedItem:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果 dragInitiator 属性包含 IAutomationObject 对象，则此属性在鼠标光标附近包含子 IAutomationObject 对象。如果 dragInitiator 属性不包含 IAutomationObject 对象，则此属性为 null。

dragInitiator

属性

public var dragInitiator:IUIComponent

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

启动拖动的组件。

dragSource

属性

public var dragSource:DragSource

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

包含正在拖动的数据的 DragSource 对象。

构造函数详细信息

()

构造函数

public function DragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, dragInitiator:IUIComponent = null, dragSource:DragSource = null, action:String = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。通常由 Flex 控件调用且不用于应用程序代码。

参数

	`type:String` — 事件类型；指示引发事件的动作。

	`bubbles:Boolean` (default = `false`) — 指定该事件是否可以在显示列表层次结构得到冒泡处理。

	`cancelable:Boolean` (default = `true`) — 指定是否可以防止与事件相关联的行为。

	`dragInitiator:IUIComponent` (default = `null`) — 指定启动拖动的组件的 IUIComponent。

	`dragSource:DragSource` (default = `null`) — 包含正在拖动的数据的 DragSource 对象。

	`action:String` (default = `null`) — 指定的放置操作，如 `DragManager.MOVE`。

	`ctrlKey:Boolean` (default = `false`) — 指示是否已按下 `Ctrl` 键。

	`altKey:Boolean` (default = `false`) — 指示是否已按下 `Alt` 键。

	`shiftKey:Boolean` (default = `false`) — 指示是否已按下 `Shift` 键。

常量详细信息

DRAG_COMPLETE

常量

public static const DRAG_COMPLETE:String = "dragComplete"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

DragEvent.DRAG_COMPLETE 常量可为 dragComplete 事件定义事件对象的 type 属性的值。

事件对象的属性有下列值：

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

DRAG_DROP

常量

public static const DRAG_DROP:String = "dragDrop"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

DragEvent.DRAG_DROP 常量可为 dragDrop 事件定义事件对象的 type 属性的值。

事件对象的属性有下列值：

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

DRAG_ENTER

常量

public static const DRAG_ENTER:String = "dragEnter"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

DragEvent.DRAG_ENTER 常量可为 dragEnter 事件定义事件对象的 type 属性的值。

事件对象的属性有下列值：

属性	值
`action`	导致此事件的操作，始终是 `DragManager.MOVE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

DRAG_EXIT

常量

public static const DRAG_EXIT:String = "dragExit"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

DragEvent.DRAG_EXIT 常量可为 dragExit 事件定义事件对象的 type 属性的值。

事件对象的属性有下列值：

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

DRAG_OVER

常量

public static const DRAG_OVER:String = "dragOver"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

DragEvent.DRAG_OVER 常量可为 dragOver 事件定义事件对象的 type 属性的值。

事件对象的属性有下列值：

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

DRAG_START

常量

public static const DRAG_START:String = "dragStart"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

DragEvent.DRAG_START 常量可为 dragStart 事件定义事件对象的 type 属性的值。

事件对象的属性有下列值：

属性	值
`action`	引发该事件的操作：`DragManager.COPY`、`DragManager.LINK`、`DragManager.MOVE` 或 `DragManager.NONE`。
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`dragInitiator`	启动拖动的组件。
`dragSource`	包含正在拖动的数据的 DragSource 对象。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。

法律声明 | 在线隐私策略

DragEvent - AS3 Flex

包x

语言元素

附录

包 mx.events

action

draggedItem

dragInitiator

dragSource

DragEvent

DRAG_COMPLETE

DRAG_DROP

DRAG_ENTER

DRAG_EXIT

DRAG_OVER

DRAG_START