DragManager - Adobe ActionScript® 3 (AS3 Flex) API 参考

包	mx.managers
类	public class DragManager
继承	DragManager Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

DragManager 类管理拖放操作，您可以使用它来将数据从 Flex 应用程序中的一个位置移动到另一位置。例如，您可以选择一个对象（如 List 控件中的项目）或一个 Flex 控件（如 Image 控件），然后将其拖至另一个组件进行添加。

DragManager 的所有方法和属性都是静态的，因此不需要为其创建实例。

所有 Flex 组件都支持拖放操作。Flex 为 List、Tree 和 DataGrid 控件的拖放操作提供了附加支持。

当用户使用鼠标选择某个项目时，所选组件称为拖动启动器。拖动操作期间显示的图像称为拖动代理。

当用户将拖动代理移动到其他组件时，系统会向该组件发送 dragEnter 事件。如果该组件接受拖动，即可成为放置目标，并接收 dragOver、dragExit 和 dragDrop 事件。

拖动操作完成后，会向拖动启动器发送 dragComplete 事件。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		isDragging : Boolean [静态] [只读] 一个只读属性，如果拖动操作正在进行，则返回 true。	DragManager

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		acceptDragDrop(target:IUIComponent):void [静态] 如果接受拖/放数据，将从 dragEnter 事件处理函数调用此方法。	DragManager
		doDrag(dragInitiator:IUIComponent, dragSource:DragSource, mouseEvent:MouseEvent, dragImage:IFlexDisplayObject = null, xOffset:Number = 0, yOffset:Number = 0, imageAlpha:Number = 0.5, allowMove:Boolean = true):void [静态] 启动拖放操作。	DragManager
		getFeedback():String [静态] 返回当前的拖放反馈。	DragManager
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		showFeedback(feedback:String):void [静态] 设置拖放操作的反馈指示符。	DragManager
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

样式

样式为常见样式，或与特定主题关联。如果为常见样式，则可以用于任何主题。如果样式与特定主题关联，则只有应用程序使用该主题时才能使用该样式。

常见样式

单击此处了解有关样式的更多信息

	说明	由以下参数定义
copyCursor	类型: Class CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 复制操作期间显示的光标。默认值为 Assets.swf 文件中的“mx.skins.cursor.DragCopy”元件。	DragManager
defaultDragImageSkin	类型: Class CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 绘制默认拖动图像（也称为拖动代理）所用的外观。默认值为 `mx.skins.halo.DefaultDragImage (for both Halo and Spark themes)`。	DragManager
linkCursor	类型: Class CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 链接操作期间显示的光标。默认值为 Assets.swf 文件中的“mx.skins.cursor.DragLink”元件。	DragManager
moveCursor	类型: Class CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 移动操作期间显示的光标。默认值为 Assets.swf 文件中的“mx.skins.cursor.DragMove”元件。	DragManager
rejectCursor	类型: Class CSS 继承: 否语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 针对拒绝操作所显示的光标。默认值为 Assets.swf 文件中的“mx.skins.cursor.DragReject”元件。	DragManager

公共常量

	常量		由以下参数定义
		COPY : String = "copy" [静态] 用于指定拖动动作的类型是“copy”的常量。	DragManager
		LINK : String = "link" [静态] 用于指定拖动动作的类型是“link”的常量。	DragManager
		MOVE : String = "move" [静态] 用于指定拖动动作的类型是“move”的常量。	DragManager
		NONE : String = "none" [静态] 用于指定拖动动作的类型是“none”的常量。	DragManager

属性详细信息

isDragging

属性

isDragging:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

一个只读属性，如果拖动操作正在进行，则返回 true。

实现
public static function get isDragging():Boolean

方法详细信息

acceptDragDrop

()

方法

public static function acceptDragDrop(target:IUIComponent):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

如果接受拖/放数据，将从 dragEnter 事件处理函数调用此方法。通常，您将 event.target 强制类型转换为放置目标的数据类型。在以下示例中，放置目标为 MX Canvas 容器：

DragManager.acceptDragDrop(Canvas(event.target));

参数

target:IUIComponent — 接受拖动的放置目标。

doDrag

()

方法

 public static function doDrag(dragInitiator:IUIComponent, dragSource:DragSource, mouseEvent:MouseEvent, dragImage:IFlexDisplayObject = null, xOffset:Number = 0, yOffset:Number = 0, imageAlpha:Number = 0.5, allowMove:Boolean = true):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

启动拖放操作。

参数

	`dragInitiator:IUIComponent` — 指定启动拖动的组件的 IUIComponent。

	`dragSource:DragSource` — 包含正在拖动的数据的 DragSource 对象。

	`mouseEvent:MouseEvent` — 包含与启动拖动相关的鼠标信息的 MouseEvent。

	`dragImage:IFlexDisplayObject` (default = `null`) — 要拖动的图像。此参数是可选的。如果省略此参数，则在拖放操作期间将使用标准的拖动矩形。如果指定了某个图像，则必须显式设置该图像的高度和宽度，否则此图像将不显示。

	`xOffset:Number` (default = `0`) — 用于指定 `dragImage` 的 x 偏移（以像素为单位）的数字。此参数是可选的。如果省略此参数，将在拖动启动器的左上角显示拖动代理。该偏移是指从拖动代理的左边缘到拖动启动器的左边缘的距离（以像素为单位），通常为负数。

	`yOffset:Number` (default = `0`) — 用于指定 `dragImage` 的 y 偏移（以像素为单位）的数字。此参数是可选的。如果省略此参数，将在拖动启动器的左上角显示拖动代理。该偏移是指从拖动代理的上边缘到拖动启动器的上边缘的距离（以像素为单位），通常为负数。

	`imageAlpha:Number` (default = `0.5`) — 用于指定拖动图像所用的 Alpha 值的数字。此参数是可选的。如果省略此参数，则默认的 Alpha 值为 0.5。值为 0.0 表示图像是透明的；值为 1.0 表示图像完全不透明。

	`allowMove:Boolean` (default = `true`) — 指示是否允许放置目标移动所拖动的数据。

getFeedback

()

方法

public static function getFeedback():String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回当前的拖放反馈。

String — 可能的返回值有：DragManager.COPY、DragManager.MOVE、DragManager.LINK 或 DragManager.NONE。

showFeedback

()

方法

public static function showFeedback(feedback:String):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

设置拖放操作的反馈指示符。可能的值有：DragManager.COPY、DragManager.MOVE、DragManager.LINK 或 DragManager.NONE。

参数

feedback:String — 要显示的反馈指示符类型。

常量详细信息

COPY

常量

public static const COPY:String = "copy"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于指定拖动动作的类型是“copy”的常量。

LINK

常量

public static const LINK:String = "link"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于指定拖动动作的类型是“link”的常量。

MOVE

常量

public static const MOVE:String = "move"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于指定拖动动作的类型是“move”的常量。

NONE

常量

public static const NONE:String = "none"

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于指定拖动动作的类型是“none”的常量。

法律声明 | 在线隐私策略

DragManager - AS3 Flex

包x

语言元素

附录

包 mx.managers

isDragging

acceptDragDrop

doDrag

getFeedback

showFeedback

COPY

LINK

MOVE

NONE