User Guide

82 ActionScript language elements
See also
getProperty function
startDrag function
startDrag(target:Object [, lock:Boolean, left:Number, top:Number,
right:Number, bottom:Number]) : Void
Makes the target movie clip draggable while the movie plays. Only one movie clip can be
dragged at a time. After a
startDrag() operation is executed, the movie clip remains
draggable until it is explicitly stopped by
stopDrag() or until a startDrag() action for
another movie clip is called.
Note: This method is supported in Flash Lite only if
System.capabilities.hasMouse is
true or System.capabilities.hasStylus is true.
Availability: ActionScript 1.0; Flash Lite 2.0
Parameters
target:Object - The target path of the movie clip to drag.
lock:Boolean [optional] - A Boolean value specifying whether the draggable movie clip is
locked to the center of the mouse position (
true ) or locked to the point where the user first
clicked the movie clip (
false ).
left,top,right,bottom:Number [optional] - Values relative to the coordinates of the movie
clip's parent that specify a constraint rectangle for the movie clip.
Example
The following example creates a movie clip, pic_mc, at runtime that users can drag to any
location by attaching the
startDrag() and stopDrag() actions to the movie clip. An image
is loaded into
pic_mc using the MovieClipLoader class.
var pic_mcl:MovieClipLoader = new MovieClipLoader();
pic_mcl.loadClip("http://www.helpexamples.com/flash/images/image1.jpg",
this.createEmptyMovieClip("pic_mc", this.getNextHighestDepth()));
var listenerObject:Object = new Object();
listenerObject.onLoadInit = function(target_mc) {
target_mc.onPress = function() {
startDrag(this);
};
target_mc.onRelease = function() {
stopDrag();
};
};
pic_mcl.addListener(listenerObject);