1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
| hitTest (méthode MovieClip.hitTest)
public hitTest() : Boolean
Evalue le clip pour savoir s'il recouvre ou recoupe la zone active identifiée par les paramètres de coordonnée target ou x et y.
Usage 1 : Compare les coordonnées x et y à la forme ou au cadre de délimitation de l'occurrence spécifiée, selon le paramètre shapeFlag. Si shapeFlag est défini sur true, seule la zone occupée par l'occurrence sur la scène est évaluée ; si x et y se chevauchent en un point quelconque, une valeur true est renvoyée. Cette évaluation est utile pour déterminer si le clip se trouve dans une zone active ou sensible spécifiée.
Usage 2 : Evalue les cadres de délimitation de l'occurrence target et spécifiée, et renvoie true s'ils se chevauchent ou se croisent en un point quelconque.
Paramètres x: Number La coordonnée x de la zone active sur la scène. y: Number Coordonnée y de la zone active de la scène. Les coordonnées x et y sont définies dans l'espace de coordonnées global. shapeFlag: Boolean Valeur booléenne indiquant s'il convient d'évaluer la forme entière de l'occurrence spécifiée (true), ou uniquement le cadre de délimitation (false). Ce paramètre peut être spécifié uniquement si la zone active est identifiée à l'aide des paramètres des coordonnées x et y. target: Object Chemin cible de la zone active susceptible de couvrir partiellement ou de recouvrir le clip. Le paramètre target représente généralement un bouton ou un champ de saisie.
Disponibilité : ActionScript 1.0 ; Flash Player 5
Valeur renvoyée
Boolean - Valeur booléenne true si le clip recouvre la zone active spécifiée, false sinon.
Exemple
L'exemple suivant utilise hitTest() pour déterminer si le clip circle_mc couvre ou recouvre partiellement le clip square_mc lorsque l'utilisateur relâche le bouton de la souris :
square_mc.onPress = function() {
this.startDrag();
};
square_mc.onRelease = function() {
this.stopDrag();
if (this.hitTest(circle_mc)) {
trace("you hit the circle");
}
}; |
Partager