Guide de reference du langage ActionScript 2.0 - PowWeb

La méthode Object.watch() se comporte de la même façon que la fonction
Object.watch() à partir de JavaScript 1.2. La principale différence est liée au paramètre
userData, qui est un ajout de Flash à Object.watch() que Netscape Navigator ne prend pas
en charge. Vous pouvez transmettre le paramètre userData au gestionnaire d'événements et
l'utiliser dans celui-ci.
La méthode Object.watch() ne peut pas observer les propriétés de lecture/définition. Les
propriétés de lecture/définition fonctionnent par l'intermédiaire d'une évaluation " paresseuse
" : la valeur de la propriété est déterminée lors de l'interrogation de la propriété. L'évaluation
« paresseuse » est souvent efficace car la propriété n'est pas constamment mise à jour ; elle est
évaluée en cas de besoin. Cependant, Object.watch() doit évaluer une propriété afin de
déterminer s'il convient d'appeler la fonction de rappel callback. Pour pouvoir travailler avec
une propriété de lecture/définition, Object.watch() doit évaluer la propriété en
permanence, ce qui n'est pas efficace.
Généralement, les propriétés ActionScript prédéfinies, telles que _x, _y, _width, et _height,
sont des propriétés de lecture/définition ne pouvant pas être observées par Object.watch().
Disponibilité : ActionScript 1.0 ; Flash Player 6
Paramètres
name:String - Chaîne ; nom de la propriété d'objet à observer.
callback:Function - Fonction à appeler lorsque la propriété observée change. Ce paramètre
est un objet de fonction et non pas un nom de fonction exprimé en tant que chaîne. La forme
de rappel callback est callback(prop, oldVal, newVal, userData).
userData:Object [facultatif] - Elément arbitraire des données ActionScript qui est transmis
à la méthode callback. Si le paramètre userData est omis, undefined est transmis à la
méthode callback.
Valeur renvoyée
Boolean - Valeur booléenne : true si le point d'observation a été créé avec succès, false
dans tous les autres cas.
Exemple
L'exemple suivant utilise watch() pour vérifier si la propriété speed a une valeur supérieure
à la limitation de vitesse :
// Create a new object
var myObject:Object = new Object();
// Add a property that tracks speed
myObject.speed = 0;
Object 1043