M > MovieClip.hitTest

MovieClip.hitTest

Disponibilité

Flash Player 5.

Usage

monClip.hitTest(x, y, baliseDeForme)
monClip.hitTest(cible)

Paramètres

x La coordonnée x de la zone d'accès sur la scène.

y La coordonnée y de la zone d'accès sur la scène.

Les coordonnées x et y sont définies dans l'espace de coordonnées global.

cible Le chemin cible de la zone active pouvant croiser ou chevaucher l'occurrence spécifiée par monClip. Le paramètre cible représente généralement un bouton ou un champ de saisie de texte.

baliseDeForme Une valeur booléenne spécifiant s'il faut évaluer la forme entière de l'occurrence spécifiée (true) ou seulement le cadre de délimitation (false). Ce paramètre ne peut être spécifié que si la zone sensible est identifiée avec les paramètres de coordonnées x et y.

Renvoie

Rien.

Description

Méthode ; évalue l'occurrence spécifiée par monClip pour voir si elle recouvre ou croise la zone identifiée par cible ou les paramètres de coordonnées x et y.

Usage 1. Compare les coordonnées x et y avec la forme ou le cadre de délimitation de l'occurrence spécifiée, en fonction du paramètre baliseDeForme. Si baliseDeForme est défini sur true, seule la zone occupée actuellement par l'occurrence sur la scène est évaluée, et si x et y se recouvrent, une valeur true est renvoyée. Cela est utile pour déterminer si le clip se trouve dans une zone sensible spécifiée.

Usage 2. Evalue les cadres de délimitation de cible et de l'occurrence spécifiée et renvoie true s'ils se croisent ou se recouvrent en un point.

Exemple

L'exemple suivant utilise hitTest avec les propriétés x_mouse et y_mouse pour déterminer si la souris se trouve sur le cadre de délimitation de la cible :

if (hitTest( _root._xmouse, _root._ymouse, false));

L'exemple suivant utilise hitTest pour déterminer si le clip balle recouvre ou croise le clip carré :

if(_root.balle, hittest(_root.carré)){
	trace("balle croise carré");
}

Voir aussi

MovieClip.getBounds, MovieClip.globalToLocal, MovieClip.localToGlobal