User Guide
480 ActionScript classes
hitArea (MovieClip.hitArea property)
public hitArea : Object
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.
Availability: ActionScript 1.0; Flash Lite 2.0
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 was 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
hitTest (MovieClip.hitTest method)
hitTest (MovieClip.hitTest method)
public hitTest() : Boolean
Evaluates the movie clip to see if it overlaps or intersects with the hit area that the target or x
and
y coordinate parameters identify.
Usage 1: Compares the x and y coordinates to the shape or bounding box of the specified
instance, according to the
shapeFlag setting. If shapeFlag is set to true, only the area
actually occupied by the instance on the Stage is evaluated, and if x and y overlap at any point,
a value of
true is returned. This evaluation is useful for determining if the movie clip is
within a specified hit or hotspot area.