Commande fscommand2 SetSoftKeys

SetSoftKeys

Reconfigure les touches programmables d'un périphérique mobile.

Lorsque l'utilisateur appuie sur une touche programmable, tout code ActionScript associé à l'évènement softkey est exécuté. Le lecteur Flash Lite exécute cette fonction immédiatement lorsqu'elle est appelée. Cette commande est prise en charge uniquement lorsque Flash Lite est en cours d'exécution en mode autonome. Elle n'est pas prise en charge lorsque le lecteur s'exécute dans le contexte d'une autre application (par exemple, en tant que module externe dans un navigateur).

Pour la compatibilité ascendante avec Flash Lite 1.1, la touche programmable SOFT1 est toujours associée à la touche gauche du combiné, puis la touche programmable SOFT2 est toujours associé à la touche droite du combiné. A partir de la touche programmable SOFT3, les emplacements dépendent du combiné.

Les arguments de cette commande spécifient le texte à afficher pour les touches programmables correspondantes. Lorsque la commande SetSoftKeys s'exécute, le fait d'appuyer sur la touche gauche génère un événement de pression de touche SOFT1 et le fait d'appuyer sur la touche droite génère un évènement de pression de touche SOFT2. Les touches programmables allant de SOFT3 à SOFT12 génèrent leurs propres événements.

Remarque : La reconfiguration des touches programmables dépend du périphérique mobile. Consultez la documentation du fabricant du périphérique pour déterminer si la reconfiguration est prise en charge.

Commande	Paramètres	Valeur renvoyée
SetSoftKeys	`soft1` Le texte à associer à la touche programmable `SOFT1`. `soft2` Le texte à associer à la touche programmable `SOFT2`. Ces paramètres peuvent être soit des noms de variable, soit des valeurs constantes de type chaîne (par exemple, "`Previous`").	-1: pas de prise en charge 0: pris en charge.

Commande

Paramètres

Valeur renvoyée

SetSoftKeys

soft1 Le texte à associer à la touche programmable SOFT1. soft2 Le texte à associer à la touche programmable SOFT2.

Ces paramètres peuvent être soit des noms de variable, soit des valeurs constantes de type chaîne (par exemple, "Previous").

-1: pas de prise en charge 0: pris en charge.

Disponibilité : ActionScript 1.0 ; Flash Lite 1.1

Exemple

L'exemple suivant nomme la touche programmable SOFT1 " Previous " et la touche programmable SOFT2 " Next " :

status = fscommand2("SetSoftKeys", "Previous", "Next");

Vous pouvez définir des variables ou utiliser des valeurs de chaîne constantes de type chaîne pour chaque touche programmable :


status = fscommand2("SetSoftKeys", soft1, soft2, [soft3], [soft4], ..., [softn])

Remarque : Vous pouvez définir une touche programmable sans définir les autres. Ces exemples illustrent la syntaxe permettant d'associer un comportement à une touche programmable spécifique sans affecter les autres touches :

Pour définir la touche programmable de gauche sur "soft1" et celle de droite sur rien :
status = fscommand2("SetSoftKeys", "soft1", "")
Pour ne pas modifier l'étiquette de la touche programmable de gauche et définir la touche programmable de droite sur " soft2 " :
status = fscommand2("SetSoftKeys", undefined, "soft2")
Pour ne pas modifier l'étiquette de la touche programmable de gauche et définir la touche programmable de droite sur "soft2" :
status = fscommand2("SetSoftKeys", null, "soft2")
Pour définir la touche programmable de gauche sur " soft1 " et conserver la touche de droite telle quelle :
status = fscommand2("SetSoftKeys", "soft1")