MACROMEDIA Flash Lite 2, Справочник

Страница: 82 / 780

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);