View comments | RSS feed

MovieClip.hitArea

Availability

Flash Player 6.

Usage

my_mc.hitArea:Object

Returns

A reference to a movie clip.

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

Comments


Humboldt Joe said on Jul 6, 2005 at 4:37 PM :
I'd love to know why I get the following error message:

**Error** Scene=Scene 1, layer=Actions, frame=1:Line 1: Left side of assignment operator must be variable or property.
map-full_mc.hitArea = _root.myHitMask_mc;

- map-full_mc is a Movie Clip instance of a Movie Clip Symbol called map_mc.
- myHitMask_mc is a Movie Clip instance of a Movie Clip Symbol called hitmask_mc.
...Other possible contributors...
- I originally assigned my shape on the scene to be a Graphic called hitmask_gr, but have since re-symbolized it to a Movie Clip called hitmask_mc.
- I tried adding "_root" to the above mentioned Action, but it didn't help.

- myHitMask_mc

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/mx2004/main_7_2/00001515.html