| 套件 | mx.managers |
| 類別 | public class DragManager |
| 繼承 | DragManager  Object |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
All methods and properties of the DragManager are static, so you do not need to create an instance of it.
All Flex components support drag and drop operations. Flex provides additional support for drag and drop to the List, Tree, and DataGrid controls.
When the user selects an item with the mouse, the selected component is called the drag initiator. The image displayed during the drag operation is called the drag proxy.
When the user moves the drag proxy over another component,
the dragEnter event is sent to that component.
If the component accepts the drag, it becomes the drop target
and receives dragOver, dragExit,
and dragDrop events.
When the drag is complete, a dragComplete event
is sent to the drag initiator.
更多範例
Dragging and dropping in multi-versioned applications
The drag-and-drop operation
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| isDragging : Boolean [靜態] [唯讀]
Read-only property that returns true
if a drag is in progress. | DragManager | ||
| 方法 | 定義自 | ||
|---|---|---|---|
[靜態]
Call this method from your dragEnter event handler if you accept
the drag/drop data. | 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 [靜態]
Initiates a drag and drop operation. | DragManager | ||
[靜態]
Returns the current drag and drop feedback. | DragManager | ||
|
指出物件是否有已定義的指定屬性。 | Object | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
[靜態]
Sets the feedback indicator for the drag and drop operation. | DragManager | ||
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
樣式可分為一般樣式及與特定主題關聯的樣式兩種。如果是一般樣式，可以與任何主題搭配使用。如果是與特定主題關聯的樣式，只有在您的應用程式使用特定主題時才能使用該樣式。
| 樣式 | 說明 | 定義自 | ||
|---|---|---|---|---|
copyCursor | 類型: Class CSS 繼承: 否 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Cursor displayed during a copy operation. The default value is the "mx.skins.cursor.DragCopy" symbol in the Assets.swf file. | DragManager | ||
defaultDragImageSkin | 類型: Class CSS 繼承: 否 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Skin used to draw the default drag image, which is also called the drag proxy. 預設值為 mx.skins.halo.DefaultDragImage (for both Halo and Spark themes)。 | DragManager | ||
linkCursor | 類型: Class CSS 繼承: 否 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Cursor displayed during a link operation. The default value is the "mx.skins.cursor.DragLink" symbol in the Assets.swf file. | DragManager | ||
moveCursor | 類型: Class CSS 繼承: 否 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Cursor displayed during a move operation. The default value is the "mx.skins.cursor.DragMove" symbol in the Assets.swf file. | DragManager | ||
rejectCursor | 類型: Class CSS 繼承: 否 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Cursor displayed for a reject operation. The default value is the "mx.skins.cursor.DragReject" symbol in the Assets.swf file. | DragManager | ||
| 常數 | 定義自 | ||
|---|---|---|---|
| COPY : String = "copy" [靜態]
Constant that specifies that the type of drag action is "copy". | DragManager | ||
| LINK : String = "link" [靜態]
Constant that specifies that the type of drag action is "link". | DragManager | ||
| MOVE : String = "move" [靜態]
Constant that specifies that the type of drag action is "move". | DragManager | ||
| NONE : String = "none" [靜態]
Constant that specifies that the type of drag action is "none". | DragManager | ||
isDragging | 屬性 |
acceptDragDrop | () | 方法 |
public static function acceptDragDrop(target:IUIComponent):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Call this method from your dragEnter event handler if you accept
the drag/drop data.
Typically, you cast event.target to the data type of the drop target.
In the following example, the drop target is an MX Canvas container:
DragManager.acceptDragDrop(Canvas(event.target));
參數
target:IUIComponent — The drop target accepting the drag.
|
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 |
Initiates a drag and drop operation.
參數
dragInitiator:IUIComponent — IUIComponent that specifies the component initiating
the drag.
| |
dragSource:DragSource — DragSource object that contains the data
being dragged.
| |
mouseEvent:MouseEvent — The MouseEvent that contains the mouse information
for the start of the drag.
| |
dragImage:IFlexDisplayObject (default = null) | |
xOffset:Number (default = 0)dragImage. This argument is optional. If omitted, the drag proxy
is shown at the upper-left corner of the drag initiator. The offset is expressed
in pixels from the left edge of the drag proxy to the left edge of the drag
initiator, and is usually a negative number.
| |
yOffset:Number (default = 0)dragImage. This argument is optional. If omitted, the drag proxy
is shown at the upper-left corner of the drag initiator. The offset is expressed
in pixels from the top edge of the drag proxy to the top edge of the drag
initiator, and is usually a negative number.
| |
imageAlpha:Number (default = 0.5) | |
allowMove:Boolean (default = true) |
getFeedback | () | 方法 |
showFeedback | () | 方法 |
public static function showFeedback(feedback:String):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Sets the feedback indicator for the drag and drop operation.
Possible values are DragManager.COPY, DragManager.MOVE,
DragManager.LINK, or DragManager.NONE.
參數
feedback:String — The type of feedback indicator to display.
|
COPY | 常數 |
public static const COPY:String = "copy"| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Constant that specifies that the type of drag action is "copy".
LINK | 常數 |
public static const LINK:String = "link"| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Constant that specifies that the type of drag action is "link".
MOVE | 常數 |
public static const MOVE:String = "move"| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Constant that specifies that the type of drag action is "move".
NONE | 常數 |
public static const NONE:String = "none"| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Constant that specifies that the type of drag action is "none".
Tue Jun 12 2018, 03:47 PM Z