用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.events 

DragEvent  - AS3 Flex

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

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

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

相关 API 元素



公共属性
 属性由以下参数定义
  action : String
所需的操作。
DragEvent
 InheritedaltKey : Boolean
表示 Alt 键是处于活动状态 (true) 还是非活动状态 (false)。
MouseEvent
 Inheritedbubbles : Boolean
[只读] 表示事件是否为冒泡事件。
Event
 InheritedbuttonDown : Boolean
表示鼠标主按键是已按下 (true) 还是未按下 (false)。
MouseEvent
 Inheritedcancelable : Boolean
[只读] 表示是否可以阻止与事件相关联的行为。
Event
 InheritedclickCount : int
[只读] 表示鼠标按下事件是否为多击序列的一部分。
MouseEvent
 InheritedcommandKey : Boolean
表示是否已激活 Command 键(仅限 Mac)。commandKey 属性的值将与 Mac 中 ctrlKey 属性的值相同。
MouseEvent
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcontrolKey : Boolean
表示在 Mac 中是否已激活 Control 键,以及在 Windows 或 Linux 中是否已激活 Ctrl 键。
MouseEvent
 InheritedctrlKey : Boolean
在 Windows 或 Linux 中,表示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。
MouseEvent
 InheritedcurrentTarget : Object
[只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
 Inheriteddelta : int
表示用户将鼠标滚轮每滚动一个单位应滚动多少行。
MouseEvent
  draggedItem : Object
如果 dragInitiator 属性包含 IAutomationObject 对象,则此属性在鼠标光标附近包含子 IAutomationObject 对象。
DragEvent
  dragInitiator : IUIComponent
启动拖动的组件。
DragEvent
  dragSource : DragSource
包含正在拖动的数据的 DragSource 对象。
DragEvent
 InheritedeventPhase : uint
[只读] 事件流中的当前阶段。
Event
 InheritedisRelatedObjectInaccessible : Boolean
如果为 true,则 relatedObject 属性是出于与安全沙箱相关的原因而设置为 null 的。
MouseEvent
 InheritedlocalX : Number
禁用鼠标锁定时,事件发生点相对于所属 Sprite 的水平坐标。
MouseEvent
 InheritedlocalY : Number
禁用鼠标锁定时,事件发生点相对于所属 Sprite 的垂直坐标。
MouseEvent
 InheritedmovementX : Number
启用鼠标锁定时,自上一次鼠标事件以来鼠标位置在 X 方向的更改。
MouseEvent
 InheritedmovementY : Number
启用鼠标锁定时,自上一次鼠标事件以来鼠标位置在 Y 方向的更改。
MouseEvent
 InheritedrelatedObject : InteractiveObject
对与事件相关的显示列表对象的引用。
MouseEvent
 InheritedshiftKey : Boolean
表示 Shift 键是处于活动状态 (true) 还是非活动状态 (false)。
MouseEvent
 InheritedstageX : Number
[只读] 事件发生点在全局舞台坐标中的水平坐标。
MouseEvent
 InheritedstageY : Number
[只读] 事件发生点在全局舞台坐标中的垂直坐标。
MouseEvent
 Inheritedtarget : Object
[只读] 事件目标。
Event
 Inheritedtype : 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
 Inherited
[覆盖] 创建 MouseEvent 对象的副本,并设置每个属性的值以匹配原始属性值。
MouseEvent
 Inherited
formatToString(className:String, ... arguments):String
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
检查是否已对事件调用 preventDefault() 方法。
Event
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
如果可以取消事件的默认行为,则取消该行为。
Event
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
 Inherited
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
[覆盖] 返回一个字符串,其中包含 MouseEvent 对象的所有属性。
MouseEvent
 Inherited
如果已修改显示列表,则将表示 Flash Player 或 Adobe AIR 在此事件处理完成后呈示结果。
MouseEvent
 Inherited
返回指定对象的原始值。
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.COPYDragManager.LINKDragManager.MOVEDragManager.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 对象。

构造函数详细信息

DragEvent

()构造函数
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.COPYDragManager.LINKDragManager.MOVEDragManager.NONE
bubblesfalse
cancelablefalse
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.COPYDragManager.LINKDragManager.MOVEDragManager.NONE
bubblesfalse
cancelablefalse
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
bubblesfalse
cancelablefalse
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.COPYDragManager.LINKDragManager.MOVEDragManager.NONE
bubblesfalse
cancelablefalse
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.COPYDragManager.LINKDragManager.MOVEDragManager.NONE
bubblesfalse
cancelablefalse
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.COPYDragManager.LINKDragManager.MOVEDragManager.NONE
bubblesfalse
cancelablefalse
currentTarget用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。
dragInitiator启动拖动的组件。
dragSource包含正在拖动的数据的 DragSource 对象。
target调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。





[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。