ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Drag and drop in AIR
import flash.desktop.NativeDragManager;
import flash.events.NativeDragEvent;
public function onDragIn(event:NativeDragEvent):void{
NativeDragManager.dropAction = NativeDragActions.MOVE;
if(event.clipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)){
NativeDragManager.acceptDragDrop(this); //'this' is the receiving component
}
}
Completing the drop
Adobe AIR 1.0 and later
When the user drops a dragged item on an interactive object that has accepted the gesture, the interactive object
dispatches a nativeDragDrop event. The handler for this event can extract the data from the clipboard property of
the event object.
When the clipboard contains an application-defined format, the transferMode parameter passed to the getData()
method of the Clipboard object determines whether the drag manager returns a reference or a serialized version of the
object.
The following example illustrates an event handler for the nativeDragDrop event:
import flash.desktop.Clipboard;
import flash.events.NativeDragEvent;
public function onDrop(event:NativeDragEvent):void {
if (event.clipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)) {
var text:String =
String(event.clipboard.getData(ClipboardFormats.TEXT_FORMAT,
ClipboardTransferMode.ORIGINAL_PREFERRED));
}
Once the event handler exits, the Clipboard object is no longer valid. Any attempt to access the object or its data
generates an error.
Updating the visual appearance of a component
Adobe AIR 1.0 and later
A component can update its visual appearance based on the NativeDragEvent events. The following table describes the
types of changes that a typical component would make in response to the different events:
Event Description
nativeDragStart The initiating interactive object can use the nativeDragStart event to provide visual feedback that the
drag gesture originated from that interactive object.
nativeDragUpdate The initiating interactive object can use the nativeDragUpdate event to update its state during the gesture.
(This event does not exist in AIR for Linux.)
nativeDragEnter A potential receiving interactive object can use this event to take the focus, or indicate visually that it can or
cannot accept the drop.
Last updated 6/6/2012
613