Guide de reference du langage ActionScript 2.0 - PowWeb

addCallback (méthode
ExternalInterface.addCallback)
public static addCallback(methodName:String, instance:Object,
method:Function) : Boolean
Enregistre une méthode ActionScript comme pouvant être appelée à partir du conteneur.
Lorsque l'invocation de addCallBack() a réussi, la fonction enregistrée dans Flash Player
peut être appelée par le code JavaScript ou ActiveX dans le conteneur.
Disponibilité : ActionScript 1.0 ; Flash Player 8
Paramètres
methodName:String - Nom utilisé pour appeler la fonction ActionScript à partir de
JavaScript. Il n'est pas nécessaire que ce nom corresponde au nom actuel de la méthode
ActionScript.
instance:Object - Objet que this convertit dans la méthode. Ce n'est pas nécessairement
l'objet sur lequel la méthode se trouve : vous pouvez spécifier n'importe quel objet (ou null).
method:Function - Méthode ActionScript à appeler à partir de JavaScript.
Valeur renvoyée
Boolean - Renvoie true si l'appel a réussi. falseest renvoyé s'il a échoué parce que
l'occurrence n'était pas disponible, en raison d'une restriction de sécurité, parce qu'aucun
objet fonction de ce type n'existait, en raison d'une erreur de récursivité, ou s'y apparentant.
Une valeur false renvoyée peut également signifier que l'environnement conteneur
appartient à un Sandbox de sécurité auquel le code effectuant l'appel n'a pas accès. Vous
pouvez contourner ce problème en définissant une valeur appropriée pour la balise
allowScriptAccess OBJECT ou EMBED du HTML de l'environnement conteneur.
Exemple
L'exemple suivant enregistre la fonction goToMacromedia() comme pouvant être appelée à
partir du conteneur du nom de goHome.
import flash.external.*;
var methodName:String = "goHome";
var instance:Object = null;
var method:Function = goToMacromedia;
var wasSuccessful:Boolean = ExternalInterface.addCallback(methodName,
instance, method);
var txtField:TextField = this.createTextField("txtField",
this.getNextHighestDepth(), 0, 0, 200, 50);
ExternalInterface (flash.external.ExternalInterface) 571