Pacotemx.managers
Classepublic class DragManager
HerançaDragManager Inheritance Object

The DragManager class manages drag and drop operations, which let you move data from one place to another in a Flex application. For exemplo, you can select an object, such as an item in a List control or a Flex control, such as an Image control, and then drag it over another component to add it to that component.

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.

Veja também

mx.core.DragSource
mx.events.DragEvent
mx.core.UIComponent

Propriedades Públicas
 PropriedadeDefinido por
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  isDragging : Boolean
[static] [read-only] Read-only property that returns true if a drag is in progress.
DragManager
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Métodos Públicos
 MétodoDefinido por
  
acceptDragDrop(target:IUIComponent):void
[static] 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
[static] Initiates a drag and drop operation.
DragManager
  
getFeedback():String
[static] Returns the current drag and drop feedback.
DragManager
 Inherited
hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations.
Object
  
showFeedback(feedback:String):void
[static] Sets the feedback indicator for the drag and drop operation.
DragManager
 Inherited
toString():String
Returns the string representation of the specified object.
Object
 Inherited
valueOf():Object
Returns the primitive value of the specified object.
Object
Estilos
 Style Descrição Definido por
  
copyCursor
Type: Classe   CSS Herança: não
Cursor displayed during a copy operation. The default value is mx.skins.cursor.DragCopy.		DragManager
  
defaultDragImageSkin
Type: Classe   CSS Herança: não
Skin used to draw the default drag image, which is also called the drag proxy. The default value is mx.skins.halo.DefaultDragImage.		DragManager
  
linkCursor
Type: Classe   CSS Herança: não
Cursor displayed during a link operation. The default value is mx.skins.cursor.DragLink.		DragManager
  
moveCursor
Type: Classe   CSS Herança: não
Cursor displayed during a move operation. The default value is mx.skins.cursor.DragMove.		DragManager
  
rejectCursor
Type: Classe   CSS Herança: não
Cursor displayed for a reject operation. The default value is mx.skins.cursor.DragReject.		DragManager
Constantes públicas
 ConstanteDefinido por
  COPY : String = "copy"
[static] Constant that specifies that the type of drag action is "copy".
DragManager
  LINK : String = "link"
[static] Constant that specifies that the type of drag action is "link".
DragManager
  MOVE : String = "move"
[static] Constant that specifies that the type of drag action is "move".
DragManager
  NONE : String = "none"
[static] Constant that specifies that the type of drag action is "none".
DragManager
Detalhes da propriedade
isDraggingpropriedade
isDragging:Boolean  [read-only]

Read-only property that returns true if a drag is in progress.


Implementação
    public static function get isDragging():Boolean
Detalhes do método
acceptDragDrop()método
public static function acceptDragDrop(target:IUIComponent):void

Call this method from your dragEnter event handler if you accept the drag/drop data. For exemplo: 

DragManager.acceptDragDrop(event.target);

Parâmetros

target:IUIComponent — The drop target accepting the drag.

doDrag()método 
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

Initiates a drag and drop operation.

Parâmetros

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) — The image to drag. This argument is optional. If omitted, a standard drag rectangle is used during the drag and drop operation. If you specify an image, you must explicitly set a height and width of the image or else it will not appear.
 
xOffset:Number (default = 0) — Number that specifies the x offset, in pixels, for the 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) — Number that specifies the y offset, in pixels, for the 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) — Number that specifies the alpha value used for the drag image. This argument is optional. If omitted, the default alpha value is 0.5. A value of 0.0 indicates that the image is transparent; a value of 1.0 indicates it is fully opaque.
 
allowMove:Boolean (default = true)

getFeedback()método 
public static function getFeedback():String

Returns the current drag and drop feedback.

Retorna
String — Possible return values are DragManager.COPY, DragManager.MOVE, DragManager.LINK, or DragManager.NONE.
showFeedback()método 
public static function showFeedback(feedback:String):void

Sets the feedback indicator for the drag and drop operation. Possible values are DragManager.COPY, DragManager.MOVE, DragManager.LINK, or DragManager.NONE.

Parâmetros

feedback:String — The type of feedback indicator to display.

Detalhes da constante
COPYConstante
public static const COPY:String = "copy"

Constant that specifies that the type of drag action is "copy".

LINKConstante 
public static const LINK:String = "link"

Constant that specifies that the type of drag action is "link".

MOVEConstante 
public static const MOVE:String = "move"

Constant that specifies that the type of drag action is "move".

NONEConstante 
public static const NONE:String = "none"

Constant that specifies that the type of drag action is "none".




© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Traduzido e mantido por Igor Costa - www.igorcosta.com