User Guide

ManualsBrandsMacromedia ManualsOtherFLASH MX 2004-ACTIONSCRIPT LANGUAGE REFERENCE

781

782

783

784

785

786

787

788

789

790

786 Chapter 2: ActionScript Language Reference

startDrag()

Availability

Flash Player 4.

Usage

startDrag(target:Object,[lock:Boolean, left:Number, top:Number, right:Number,

bottom:Number]) : Void

Parameters

target

The target path of the movie clip to drag.

lock 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).

This parameter is optional.

left, top, right, bottom Values relative to the coordinates of the movie clip’s parent that

specify a constraint rectangle for the movie clip. These parameters are optional.

Returns

Nothing.

Description

Function; 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.

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.macromedia.com/devnet/mx/blueprint/articles/

qa_petmarket/spotlight_thale.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);