<< Retour au sommaire

 

L’ÉDITEUR SCRIPTS MANAGER

 

 

 

Table des matières

  1. Ouvrir l’éditeur ;
  2. Ouvrir le fichier source par défaut ;
  3. Compiler vos modifications ;
  4. Circuler dans le fichier source ;
  5. Supprimer un script ou une fonction ;
  6. Atteindre la description d’un script ou d’une fonction ;
  7. Insérer un appel de fonction ;
  8. Insérer l’exécution d’un script ;
  9. Rechercher un texte dans le fichier source ;
  10. Les commentaires ;
  11. Sélectionner un script ou une fonction ;
  12. Inclure les fichiers d’en-tête.

 

Ouvrir l’éditeur

 

Insère +J, puis : « Utilitaires (sous menu,) », « Éditeur de scripts ».

 

Ouvrir le fichier source par défaut 

 

ALT, « Fichier », « Ouvrir le fichier DEFAULT ».

 

Compiler vos modifications

 

ALT, « Fichier », « Enregistrer ».

 

Si vous avez une erreur de compilation, le compilateur vous affichera un message relatif à la nature de l’erreur. Après avoir pris connaissance du message, vous pourrez presser la touche entrée afin que votre curseur soit positionné à l’endroit exact où le compilateur a détecté une anomalie.

En revanche, si la compilation réussit, un message de succès sera émis par JAWS et votre curseur se replacera automatiquement à l’endroit exact depuis lequel vous avez lancé la compilation.

 

Circuler dans le fichier source

 

Pour circuler à travers les différents scripts et fonctions de votre fichier source, vous pouvez utiliser les raccourcis clavier suivants :

 

Mais vous pouvez également ouvrir la liste des scripts et fonctions du fichier source en réalisant le raccourci clavier CTRL +L. La liste des scripts apparaît à l’écran. Vous pouvez rechercher le script de votre choix en circulant verticalement ou en pressant la première lettre du script que vous recherchez. Dès que vous serez positionnés sur le nom du script à atteindre, pressez la touche « entrée ».

Aussitôt, vous serez positionnés sur la première ligne du script…

Remarque :

·        Bien sûr, le raccourci clavier CTRL +L est un raccourci d’une commande du menu déroulant :

ALT,  Script », « Liste des scripts ».

 

Supprimer un script ou une fonction

 

Pour supprimer un script ou une fonction, positionnez votre curseur à l’intérieur du script ou bien, sur son nom situé dans la ligne d’en-tête, puis réalisez le raccourci clavier CTRL +Supprime.

 

Dans le menu déroulant, vous trouverez cette option ici :

ALT, Script », « Supprimer un script ».

 

Atteindre la Description d’un script ou d’une fonction

 

Lorsque vous souhaitez accéder à la boîte de dialogue à partir de laquelle vous avez créé le script ou la fonction, placez le curseur dans le script ou la fonction concerné et réalisez le raccourci clavier CTRL +D.

Ou bien sûr, depuis le menu déroulant :

ALT, « Affichage », « Documentation ».

 

Cette boîte de dialogue contient le nom du script, la case à cocher intitulé « « Peut être rattaché à une touche », la zone « Résumé », la zone Description », le raccourci clavier s’il y en a un, et les différents types de variables s’il s’agit d’une fonction. Si vous effectuez des modifications dans cette boîte de dialogue, vous devrez valider le bouton « Ok » en pressant la touche entrée.

Puis, de retour dans le fichier source, n’oubliez pas de compiler…

 

Insérer un appel de fonction

 

Lorsque vous souhaitez insérer une fonction existante à l’intérieur d’un script ou dans une autre fonction, positionnez-vous à l’endroit exact du fichier source où vous souhaitez effectuer l’insertion, puis réalisez le raccourci clavier CTRL +I.

Dans la boîte de dialogue qui apparaît à l’écran, faites tabulation, puis positionnez-vous sur la fonction à insérer.

Remarque :

·        Pour rechercher la fonction dans la liste, vous pouvez utiliser les flèches verticales ou saisir les premières lettres du nom de la fonction.

 

Pour ouvrir la liste des fonctions, vous pouvez également passer par le menu déroulant :

ALT, « Script », « Insérer un appel de fonction ».

 

Insérer l’exécution d’un script

 

Lorsque vous souhaitez insérer un script  existant à l’intérieur d’un script ou d’une fonction, dans le fichier source, positionnez-vous à l’endroit où vous souhaitez effectuer l’insertion, puis réalisez le raccourci clavier MAJ +CTRL +I.

Dans la boîte de dialogue qui apparaît à l’écran, vous êtes dans la liste des scripts définis dans le fichier source courant et dans le fichier « default.JSS.

Dans cette liste, circulez avec les flèches verticales ou saisissez au clavier les premières lettres du nom du script recherché.

Dès lors que vous êtes positionnés sur le script à insérer, pressez la touche « Entrée ».

 

Contrairement à la fonction, le nom du script sera inséré précédé du mot clé :

« PerformScript ».

 

Remarque :

·        La boîte de dialogue qui permet d’afficher la liste des scripts est également disponible depuis le menu déroulant :

ALT, « Script », « Insérer l’exécution d’un script ».

 

Rechercher un texte dans le fichier source

 

Pour atteindre une chaîne de caractères à l’intérieur d’un fichier source, validez la commande du menu :

ALT, « Édition », « Rechercher », ou le raccourci clavier CTRL +F.

Dans la boîte de dialogue qui apparaît à l’écran, saisissez immédiatement la chaîne de caractères que vous recherchez, puis pressez la touche « entrée ».

Ensuite pressez la touche « Échappement » pour refermer la fenêtre. Vous serez directement positionnés sur la première chaîne de caractères correspondant à votre recherche.

Pour que JAWS ne s’embrouille pas dans la lecture, pressez la touche Origine afin de positionner le curseur au début de la ligne trouvée.

Pour continuer la recherche, pressez la touche de fonction F3.

 

Les commentaires

 

Il est conseillé d’introduire des commentaires à l’intérieur du code afin que vous puissiez vous y retrouver le jour où vous reviendrez réaliser des modifications.

Les commentaires doivent toujours être précédés du signe « points virgule».

Dans une ligne, tout ce qui se trouve à droite du signe « points virgule» sera ignoré par le compilateur.

Par exemple :

JAWSPageUp () ;déplace le curseur en haut de la fenêtre.

 

Sélectionner un script ou une fonction

 

Pour sélectionner l’intégralité d’un script ou d’une fonction, positionnez-vous sur la ligne d’en-tête du script ou de la fonction à sélectionner, puis réalisez le raccourci clavier CTRL +R.

Dès lors que la sélection est faite, rien ne vous empêche de réaliser une copie dans le presse papier, CTRL +C.

 


Inclure des fichiers d’en-tête

 

Dans l’écriture de scripts et de fonctions, nous utilisons parfois des variables globales et des constantes qui sont déclarées et définies dans des fichiers de type « en-tête » et dont l’extension est « JSH ».

 

A titre d’exemple, on utilise régulièrement les constantes « TRUE » et « FALSE », par exemple dans le code de la gestion du configurateur.

 

Eh bien, pour que nous puissions utiliser ces constantes, nous devons impérativement insérer le fichier qui contient leur déclaration, et ce,  dans l’en-tête de notre fichier source, c’est la raison pour laquelle on les appelles « les fichiers d’en-tête ».

 

Les constantes intégrées se trouvent dans le fichier « HJCONST.JSH ».

Quant aux variables globales intégrées, elles sont déclarées dans le fichier « HJGLOBAL.JSH ».

 

Pour insérer ces 2 fichiers de déclarations dans votre fichier source, vous devez commencer le code par les lignes suivantes :

 

Include "HJCONST.JSH"

Include "HJGLOBAL.JSH"

 

Philippe BOULANGER