User Guide
586 Chapter 7: ActionScript for Flash
Description
Property; designates another movie clip to serve as the hit area for a movie clip. If the hitArea
property does not exist or is
null or undefined, the 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 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.
Example
The following example sets the circle_mc movie clip as the hit area for the square_mc movie
clip. Place these two movie clips on the Stage and test the document. When you click
circle_mc,
the
square_mc movie clip traces that it has been clicked.
square_mc.hitArea = circle_mc;
square_mc.onRelease = function() {
trace("hit! "+this._name);
};
You can also set the circle_mc movie clip visible property to false to hide the hit area for
square_mc.
circle_mc._visible = false;
See Also
MovieClip.hitTest()
MovieClip.hitTest()
Availability
Flash Player 5.
Usage
my_mc.hitTest(x:Number, y:Number, shapeFlag:Boolean) : Boolean
my_mc.hitTest(target:Object) : Boolean
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.