MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE, Reference

Page: 517 / 1104

MovieClip.getBounds() 517
MovieClip.getBounds()
Availability
Flash Player 5.
Usage
my_mc .getBounds( targetCoordinateSpace:Object ) : Object
Parameters
targetCoordinateSpace
The target path of the Timeline whose coordinate system you want
to use as a reference point.
Returns
An object with the properties
xMin
,
xMax
,
yMin
, and
yMax.
Description
Method; returns properties that are the minimum and maximum x and y coordinate values of the
instance specified by
my_mc
for the
targetCoordinateSpace
parameter.
Note: Use
MovieClip.localToGlobal()
and
MovieClip.globalToLocal()
to convert the movie clip’s
local coordinates to Stage coordinates, or Stage coordinates to local coordinates, respectively.
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 movie clip called
square_mc
. The code draws a square for that
movie clip and uses
MovieClip.getBounds()
to display the coordinate values of the instance in
the Output panel.
this.createEmptyMovieClip("square_mc", 1);
square_mc._x = 10;
square_mc._y = 10;
square_mc.beginFill(0xFF0000);
square_mc.moveTo(0, 0);
square_mc.lineTo(100, 0);
square_mc.lineTo(100, 100);
square_mc.lineTo(0, 100);
square_mc.lineTo(0, 0);
square_mc.endFill();
var bounds_obj:Object = square_mc.getBounds(this);
for (var i in bounds_obj) {
trace(i+" --> "+bounds_obj[i]);
}
The following information displays in the Output panel:
yMax --> 110
yMin --> 10
xMax --> 110
xMin --> 10