ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Drag and drop in AIR
Drag effects in HTML
Adobe AIR 1.0 and later
The initiator of the drag gesture can limit the allowed drag effects by setting the dataTransfer.effectAllowed
property in the handler for the dragstart event. The following string values can be used:
String value Description
"none" No drag operations are allowed.
"copy" The data will be copied to the destination, leaving the original in place.
"link" The data will be shared with the drop destination using a link back to the original.
"move” The data will be copied to the destination and removed from the original location.
"copyLink" The data can be copied or linked.
"copyMove" The data can be copied or moved.
"linkMove" The data can be linked or moved.
"all" The data can be copied, moved, or linked. All is the default effect when you prevent the default behavior.
The target of the drag gesture can set the dataTransfer.dropEffect property to indicate the action that is taken if
the user completes the drop. If the drop effect is one of the allowed actions, then the system displays the appropriate
copy, move, or link cursor. If not, then the system displays the unavailable cursor. If no drop effect is set by the target,
the user can choose from the allowed actions with the modifier keys.
Set the dropEffect value in the handlers for both the dragover and dragenter events:
function doDragStart(event) {
event.dataTransfer.setData("text/plain","Text to drag");
event.dataTransfer.effectAllowed = "copyMove";
}
function doDragOver(event) {
event.dataTransfer.dropEffect = "copy";
}
function doDragEnter(event) {
event.dataTransfer.dropEffect = "copy";
}
Note: Although you should always set the dropEffect property in the handler for dragenter, be aware that the next
dragover event resets the property to its default value. Set dropEffect in response to both events.
Dragging data out of an HTML element
Adobe AIR 1.0 and later
The default behavior allows most content in an HTML page to be copied by dragging. You can control the content
allowed to be dragged using CSS properties -webkit-user-select and -webkit-user-drag.
Override the default drag-out behavior in the handler for the dragstart event. Call the setData() method of the
dataTransfer property of the event object to put your own data into the drag gesture.
Last updated 6/6/2012
617