adobe.utilsXMLUI La classe XMLUI autorise les communications avec les fichiers SWF qui sont utilisés comme interfaces utilisateur personnalisées pour les fonctions d’extension de l’outil de création de Flash.XMLUI Object La classe XMLUI autorise les communications avec les fichiers SWF qui sont utilisés comme interfaces utilisateur personnalisées pour les fonctions d’extension de l’outil de création de Flash.

Macromedia Flash MX 2004, Macromedia Flash MX Professional 2004 et les versions ultérieures présentent plusieurs fonctions d’extensibilité incluant Comportements, Commandes (JavaScript API), Effets et Outils. Avec ces fonctions, les utilisateurs expérimentés peuvent développer ou automatiser les capacités de l’outil de création. Le moteur XML vers UI fonctionne avec ces fonctions d’extensibilité pour créer des boîtes de dialogue qui s’affichent lorsque l’extension nécessite ou valide des paramètres. Vous pouvez définir les boîtes de dialogue à l’aide de balises XML ou en créant un fichier SWF pour l’affichage. l’objet XMLUI fournit un mécanisme par lequel un utilisateur avancé peut communiquer avec un fichier SWF utilisé de cette manière.

accept Ferme la boîte de dialogue XMLUI actuelle avec l’état d’acceptation.XMLUI, XMLUI.accept(), accept() Ferme la boîte de dialogue XMLUI actuelle avec l’état d’acceptation. Cette opération est identique à un clic de l’utilisateur sur le bouton OK. cancel Ferme la boîte de dialogue XMLUI actuelle avec l’état d’annulation.XMLUI, XMLUI.cancel(), cancel() Ferme la boîte de dialogue XMLUI actuelle avec l’état d’annulation. Cette opération est identique à un clic de l’utilisateur sur le bouton Annuler. getProperty Extrait la valeur de la propriété spécifiée de la boîte de dialogue XMLUI actuelle.XMLUI, XMLUI.getProperty(), getProperty() Valeur de la propriété. StringnameStringNom de la propriété XMLUI à extraire. Extrait la valeur de la propriété spécifiée de la boîte de dialogue XMLUI actuelle. setProperty Modifie la valeur de la propriété spécifiée de la boîte de dialogue XMLUI actuelle.XMLUI, XMLUI.setProperty(), setProperty() nameStringNom de la propriété XMLUI à modifier. valueStringValeur que prendra la propriété spécifiée. Modifie la valeur de la propriété spécifiée de la boîte de dialogue XMLUI actuelle. CustomActions Les méthodes de la classe CustomActions permettent de lire un fichier SWF dans l’outil de création de Flash pour gérer des actions personnalisées enregistrées via cet outil.CustomActions object, CustomActions, built-in class Object Les méthodes de la classe CustomActions permettent de lire un fichier SWF dans l’outil de création de Flash pour gérer des actions personnalisées enregistrées via cet outil. Un fichier SWF peut installer et désinstaller des actions personnalisées, récupérer leur définition XML et récupérer la liste des actions personnalisées enregistrées.

Vous pouvez utiliser ces méthodes pour créer des fichiers SWF qui sont des extensions de l’outil de création de Flash. Ces extensions peuvent par exemple utiliser le protocole d’application Flash pour naviguer dans un référentiel UDDI (Universal Description, Discovery and Integration) et télécharger des services Web dans la boîte à outils Actions.

getActions Lit le contenu du fichier de définition XML des actions personnalisées nommé name.CustomActions.getActions, CustomActions, getActions Si la définition XML d’actions personnalisées est localisée, une chaîne est renvoyée. Sinon, undefined est renvoyé. StringnameStringNom de la définition d’action personnalisée à extraire. Lit le contenu du fichier de définition XML d’actions personnalisées nommé name.

Le nom du fichier de définition doit être simple, sans extension .xml et sans aucun des caractères de séparation de répertoire (« : », « / » et « \ »).

Si le fichier de définition spécifié par le paramètre name est introuvable, une valeur undefined est renvoyée. Si la définition XML d’actions personnalisées spécifiée par le paramètre name est localisée, elle est lue intégralement et renvoyée sous forme de chaîne.

installActions Installe un nouveau fichier de définition XML des actions personnalisées indiqué par le paramètre name. La valeur booléenne false est renvoyée si une erreur se produit au cours de l’installation ; sinon, la valeur true est renvoyée pour indiquer que l’action personnalisée a été installée avec succès. nameStringNom de la définition d’action personnalisée à installer. dataStringTexte de la définition XML à installer. Installe un nouveau fichier de définition XML des actions personnalisées indiqué par le paramètre name. Le contenu du fichier est spécifié par la chaîne data.

Le nom du fichier de définition doit être simple, sans extension .xml et sans aucun des caractères de séparation de répertoire (« : », « / » et « \ »).

Si un fichier d’actions personnalisées portant le nom name existe déjà, il est remplacé.

Si le répertoire Configuration/ActionsPanel/CustomActions n’existe pas lorsque cette méthode est appelée, il est créé.

uninstallActions Supprime le fichier de définition XML des actions personnalisées nommé name.CustomActions.uninstallActions, CustomActions, uninstallActions nameStringNom de la définition d’action personnalisée à désinstaller. Supprime le fichier de définition XML d’actions personnalisées nommé name.

Le nom du fichier de définition doit être simple, sans extension .xml et sans aucun des caractères de séparation de répertoire (« : », « / » et « \ »).

installActions()actionsList Renvoie un objet Array contenant les noms de toutes les actions personnalisées enregistrées via l’outil de création de Flash.CustomActions.listActions, CustomActions, listActions Array Renvoie un objet Array contenant les noms de toutes les actions personnalisées enregistrées via l’outil de création de Flash. Les éléments du tableau portent des noms simples, sans extension de fichier .xml et sans caractère de séparation de répertoire (par exemple, ":", "/" ou "\"). Si aucune action personnalisée n’est enregistrée, actionsList() renvoie un tableau de longueur zéro. Si une erreur se produit, actionsList() renvoie la valeur undefined. MMEndCommand Indique à une application hébergeant une commande SWF qu’une commande est terminée et lui demande de valider ou d’annuler les modifications dues à la commande MMExecute().endStatusBoolean Valeur booléenne ; utilise true pour valider les modifications, sinon false. Si défini sur false, toutes les modifications en attente sont annulées. notifyStringString Chaîne contenant un message d’erreur ou la raison pour laquelle les modifications vont être annulées. Si le paramètre endStatus est true, utilisez une chaîne vide pour la valeur du paramètre notifyString. Indique à une application hébergeant une commande SWF qu’une commande est terminée et lui demande de valider ou d’annuler les modifications dues à la commande MMExecute(). MMExecute Permet de publier des commandes de l’API Flash JavaScript (JSAPI) à partir d’ActionScript. Le résultat représenté sous forme de chaîne, s’il y en a un, renvoyé par l’instruction JavaScript. StringnameString Une chaîne transmise à MMExecute(). MMExecute() analyse la chaîne et exécute toutes commandes JavaScript. Vous pouvez affecter une variable à la chaîne, puis la transmettre à MMExecute(). Vous pouvez également diviser votre fonction JavaScript en chaînes plus petites ; MMExecute() renvoie la valeur de la dernière fonction appelée. Permet de publier des commandes de l’API Flash JavaScript (JSAPI) à partir d’ActionScript. Dans Flash Professional, la fonction MMExecute peut être appelée uniquement par une animation utilisée en tant que panneau Flash, par une boîte de dialogue XMLtoUI ou par l’interface utilisateur personnalisée d’un composant. Les commandes JSAPI n’ont aucun effet en dehors de l’environnement de création.

La JSAPI de Flash comporte plusieurs objets, méthodes et propriétés permettant de dupliquer ou d’émuler les commandes pouvant être entrées par un utilisateur dans l’environnement de création. A l’aide de JSAPI, vous pouvez écrire des scripts qui étendent les fonctionnalités de Flash de plusieurs manières : ajout de commandes aux menus, manipulation d’objets sur la Scène, répétition de séquences de commandes, etc.

De manière générale, un utilisateur exécute un script JSAPI en sélectionnant Commandes > Exécuter la commande. Cependant, vous pouvez utiliser cette fonction dans un script ActionScript pour appeler directement une commande JSAPI. Si vous utilisez MMExecute() dans un script pour l’image 1 de votre fichier, la commande s’exécute lors du chargement du fichier SWF.

Pour plus d’informations sur JSAPI, voir « Extension de Flash » à l’adresse http://www.adobe.com/go/jsapi_info_fr.