F > fscommand

fscommand

Disponibilité

Flash Player 3.

Usage

fscommand("commande", "paramètres")

Paramètres

commande Une chaîne transmise à l'application hôte pour toute utilisation ou une commande transmise à Flash Player.

paramètres Une chaîne transmise à l'application hôte pour toute utilisation ou une valeur transmise à Flash Player.

Renvoie

Rien.

Description

Action ; permet à l'animation Flash de communiquer avec Flash Player ou avec le programme hébergeant Flash Player, tel qu'un navigateur web. Vous pouvez également utiliser l'action fscommand pour transmettre des messages à Macromedia Director, ou à Visual Basic, Visual C++ et tout autre programme capable d'héberger les contrôles ActiveX.

Usage 1. Pour envoyer un message à Flash Player, vous devez utiliser des commandes et paramètres prédéfinis. Le tableau suivant indique les valeurs que vous pouvez spécifier pour les paramètres commande et paramètres de l'action fscommand pour contrôler une animation lue dans le lecteur Flash autonome (y compris les projections) :

Commande	Paramètres	Objectif
quit	Aucun	Ferme la projection.
fullscreen	true ou false	La spécification de true définit Flash Player en mode plein écran. La spécification de false renvoie le lecteur en affichage normal du menu.
allowscale	true ou false	La spécification de false définit le lecteur de sorte qu'il soit toujours affiché dans sa taille originale et jamais redimensionné. La spécification de true oblige l'animation à adopter 100 % de l'échelle du lecteur.
showmenu	true ou false	La spécification de true active le jeu complet des éléments de menu contextuel. La spécification de false masque tous les éléments de menu contextuel, à l'exception de A propos de Flash Player.
exec	chemin vers l'application	Exécute une application depuis la projection.
trapallkeys	true ou false	La spécification de true envoie tous les éléments de touche, y compris les raccourcis, au gestionnaire onClipEvent(keyDown/keyUp) de Flash Player.

Usage 2. Pour utiliser l'action fscommand pour envoyer un message à un langage de programmation tel que JavaScript dans un navigateur web, vous pouvez transmettre deux paramètres quelconques dans les paramètres commande et paramètres. Ces paramètres peuvent être des chaînes ou des expressions et sont utilisés dans une fonction JavaScript qui traite l'action fscommand.

Dans un navigateur web, l'action fscommand appelle la fonction JavaScript moviename_DoFScommand dans la page HTML contenant l'animation Flash. moviename est le nom de Flash Player, tel qu'affecté par l'attribut NAME de la balise EMBED ou la propriété ID de la balise OBJECT. Si le nom monAnimation a été affecté à Flash Player, la fonction JavaScript appelée est monAnimation_DoFScommand.

Usage 3. L'action fscommand peut envoyer des messages à Macromedia Director qui sont interprétés par Lingo comme des chaînes, des événements ou un code exécutable Lingo. Si le message est une chaîne ou un événement, vous devez rédiger le code Lingo pour le recevoir depuis l'action fscommand et entraîner une action dans Director. Pour plus d'informations, consultez le centre de support de Director.

Usage 4. En Visual Basic, Visual C++, et dans d'autres programmes pouvant héberger les contrôles ActiveX, fscommand envoie un événement VB avec deux chaînes qui peut être traité dans l'environnement du langage de programmation. Pour plus d'informations, utilisez les mots-clés méthode Flash pour effectuer une recherche sur le centre de support de Flash.

Exemple

Usage 1. Dans l'exemple suivant, l'action fscommand définit Flash Player pour qu'il affiche l'animation en taille plein écran lorsque le bouton est relâché.

on(release) {
	fscommand("fullscreen", true);
}

Usage 2. L'exemple suivant utilise l'action fscommand appliquée à un bouton dans Flash pour ouvrir une boîte de message JavaScript dans une page HTML. Le message même est envoyé à JavaScript en tant que paramètre de fscommand.

Vous devez ajouter une fonction à la page HTML contenant l'animation Flash. Cette fonction, monAnimation_DoFSCommand, réside dans la page HTML et attend une action fscommand dans Flash. Lorsqu'une action fscommand est déclenchée dans Flash (par exemple, lorsqu'un utilisateur clique sur le bouton), les chaînes commande et paramètres sont transmises à la fonction monAnimation_DoFSCommand. Vous pouvez utiliser les chaînes transmises dans votre code JavaScript ou VBScript comme vous l'entendez. Dans cet exemple, la fonction contient une instruction conditionnelle if qui vérifie si la chaîne de commande est "boîteDeMessage". Le cas échéant, une boîte d'alerte JavaScript s'ouvre et affiche le contenu de la chaîne paramètres.

function monAnimation_DoFSCommand(commande, paramètres) {
	if (command == "boîteDeMessage") {
		alert(paramètres);
	}

}

Dans le document Flash, ajoutez l'action fscommand à un bouton :

fscommand("boîteDeMessage", "Ceci est une boîte appelée depuis Flash.")

Vous pouvez également utiliser des expressions pour l'action et les paramètres fscommand, comme dans l'exemple suivant :

fscommand("boîteDeMessage", "Bonjour, " + nom + ", bienvenue sur notre site web!")

Pour tester l'animation, choisissez Fichier > Aperçu avant publication > HTML.

Remarque   Si vous publiez votre animation avec le modèle Flash et FSCommand dans les paramètres de publication HTML, la fonction monAnimation_DoFSCommand est insérée automatiquement. Les attributs NAME et ID de l'animation seront le nom du fichier. Par exemple, pour le fichier monAnimation.fla, les attributs seraient définis avec monAnimation.