DragManager - API-referens för Adobe ActionScript® 3 (AS3 Flex)

Paket	mx.managers
Klass	public class DragManager
Arv	DragManager Object

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

The DragManager class manages drag and drop operations, which let you move data from one place to another in a Flex application. For example, 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.

Fler exempel

Dragging and dropping in sandboxed applications
Dragging and dropping in multi-versioned applications
The drag-and-drop operation

Relaterade API-element

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

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		isDragging : Boolean [statisk] [skrivskyddad] Read-only property that returns true if a drag is in progress.	DragManager

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		acceptDragDrop(target:IUIComponent):void [statisk] 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 [statisk] Initiates a drag and drop operation.	DragManager
		getFeedback():String [statisk] Returns the current drag and drop feedback.	DragManager
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		showFeedback(feedback:String):void [statisk] Sets the feedback indicator for the drag and drop operation.	DragManager
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object

Format

Format är antingen allmänna eller kopplade till ett visst tema. Om formatet är allmänt kan det användas med alla teman. Om ett format är kopplat till ett visst tema kan det bara användas om programmet använder just det temat.

Vanliga format

Klicka för mer information om stilar

	Beskrivning	Definieras med
copyCursor	Typ: Class CSS-arv: Nej Språkversion: ActionScript 3.0 Produktversion: Flex 3 Körningsmiljöversioner: 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	Typ: Class CSS-arv: Nej Språkversion: ActionScript 3.0 Produktversion: Flex 3 Körningsmiljöversioner: Flash9, AIR 1.1 Skin used to draw the default drag image, which is also called the drag proxy. Standardvärdet är `mx.skins.halo.DefaultDragImage (for both Halo and Spark themes)`.	DragManager
linkCursor	Typ: Class CSS-arv: Nej Språkversion: ActionScript 3.0 Produktversion: Flex 3 Körningsmiljöversioner: 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	Typ: Class CSS-arv: Nej Språkversion: ActionScript 3.0 Produktversion: Flex 3 Körningsmiljöversioner: 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	Typ: Class CSS-arv: Nej Språkversion: ActionScript 3.0 Produktversion: Flex 3 Körningsmiljöversioner: 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

Publika konstanter

	Konstant		Definieras med
		COPY : String = "copy" [statisk] Constant that specifies that the type of drag action is "copy".	DragManager
		LINK : String = "link" [statisk] Constant that specifies that the type of drag action is "link".	DragManager
		MOVE : String = "move" [statisk] Constant that specifies that the type of drag action is "move".	DragManager
		NONE : String = "none" [statisk] Constant that specifies that the type of drag action is "none".	DragManager

Egenskapsdetaljer

isDragging

egenskap

isDragging:Boolean [skrivskyddad]

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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

Implementering
public static function get isDragging():Boolean

Metoddetaljer

acceptDragDrop

()

metod

public static function acceptDragDrop(target:IUIComponent):void

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

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));

Parametrar

target:IUIComponent — The drop target accepting the drag.

doDrag

()

metod

 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

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

Initiates a drag and drop operation.

Parametrar

	`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`) — Indicates if a drop target is allowed to move the dragged data.

getFeedback

()

metod

public static function getFeedback():String

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

Returns the current drag and drop feedback.

Returnerar

String — Possible return values are DragManager.COPY, DragManager.MOVE, DragManager.LINK, or DragManager.NONE.

showFeedback

()

metod

public static function showFeedback(feedback:String):void

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

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.

Parametrar

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

Konstantdetaljer

COPY

Konstant

public static const COPY:String = "copy"

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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

LINK

Konstant

public static const LINK:String = "link"

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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

MOVE

Konstant

public static const MOVE:String = "move"

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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

NONE

Konstant

public static const NONE:String = "none"

Språkversion:

ActionScript 3.0

Produktversion:

Flex 3

Körningsmiljöversioner:

Flash Player 9, AIR 1.1

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

Juridiska meddelanden | Onlinesekretesspolicy

DragManager - AS3 Flex

Klasser x

isDragging

acceptDragDrop

doDrag

getFeedback

showFeedback

COPY

LINK

MOVE

NONE