MovieClip.stopDrag()

Availability

Flash Player 5.

Usage

my_mc.stopDrag() : Void

Parameters

None.

Returns

Nothing.

Description

Method; ends a MovieClip.startDrag() method. A movie clip that was made draggable with that method remains draggable until a stopDrag() method is added, or until another movie clip becomes draggable. Only one movie clip is draggable at a time.

You can extend the methods and event handlers of the MovieClip class by creating a subclass. For more information, see "Assigning a class to a movie clip symbol" in Using ActionScript in Flash.

Example

The following example creates a draggable movie clip instance called image_mc. A MovieClipLoader object is used to load an image into image_mc.

this.createEmptyMovieClip("image_mc", 1);
var mclListener:Object = new Object();
mclListener.onLoadInit = function(target_mc:MovieClip) {
   target_mc.onPress = function() {
      this.startDrag();
   };
   target_mc.onRelease = function() {
      this.stopDrag();
   };
};
var image_mcl:MovieClipLoader = new MovieClipLoader();
image_mcl.addListener(mclListener);
image_mcl.loadClip("http://www.macromedia.com/devnet/blueprint/articles/nielsen/spotlight_jnielsen.jpg", image_mc);