MovieClip.hitTest() 509
MovieClip.hitArea
Availability
Flash Player 6.
Usage
my_mc.hitArea
Returns
A reference to a movie clip.
Description
Property; designates another movie clip to serve as the hit area for a button movie clip. If the
hitArea property does not exist or is null or undefined, the button movie clip itself is used as
the hit area. The value of the
hitArea property may be a reference to a movie clip object.
You can change the
hitArea property at any time; the modified button movie clip immediately
takes on the new hit area behavior. The movie clip designated as the hit area does not need to be
visible; its graphical shape, although not visible, is hit-tested. The
hitArea property can be read
out of a prototype object.
MovieClip.hitTest()
Availability
Flash Player 5.
Usage
my_mc.hitTest(x, y, shapeFlag)
my_mc.hitTest(target)
Parameters
x
The x coordinate of the hit area on the Stage.
y The y coordinate of the hit area on the Stage.
The x and y coordinates are defined in the global coordinate space.
target The target path of the hit area that may intersect or overlap with the instance specified
by
my_mc. The target parameter usually represents a button or text-entry field.
shapeFlag A Boolean value specifying whether to evaluate the entire shape of the specified
instance (
true), or just the bounding box (false). This parameter can be specified only if the hit
area is identified using
x and y coordinate parameters.
Returns
A Boolean value of true if my_mc overlaps with the specified hit area, false otherwise.
Description
Method; evaluates the instance specified by my_mc to see if it overlaps or intersects with the hit
area identified by the
target or x and y coordinate parameters.