<< Retour au sommaire

 

Say et Spell, Les scripts et fonctions de lecture

 

 

 

Table des matières

  1. SayString et SayInteger, lire les données passées en paramètres

1.1  SayString ;

1.2  SayInteger.

  1. Des scripts et des fonctions de lecture à l’écran

2.1  SayCharacter ;

2.2  SayPriorCharacter ;

2.3  SayNextCharacter ;

2.4  SayWord ;

2.5  SayPriorWord ;

2.6  SayNextWord ;

2.7  SayLine ;

2.8  SayPriorLine ;

2.9  SayNextLine ;

2.10         SayFromCursor ;

2.11         SayColor ;

2.12         SayFont ;

2.13         SayWindowTitle ;

2.14         SayAll ;

2.15         SayField ;

2.16         SayWindowPromptAndText.

  1. Les fonctions d’épellation

3.1  SpellString ;

3.2  SpellWord ;

3.3  SpellLine.

 

SayString & SayInteger, lire les données passées en paramètres

 

JAWS peut lire des informations variées à partir des fonctions commençant par le mot Say.

« Say » signifiant « dire »…

Commençons par SayString.

SayString :

 

La syntaxe :

SayString (“le texte”)

 

La description :

SayString déclenche la lecture du texte qui lui est passé en paramètre.

Le véritable texte doit être impérativement encadré par des guillemets, et peut être représenté par une variable de type « String », dans quel cas le nom de cette variable n’est pas placé entre guillemets, c’est ainsi que le compilateur fera la distinction entre une chaîne de caractères, donc du texte de type alphanumérique, et une variable.

 

Pour dire bonjour :

SayString ("Bonjour")

JAWS dit « bonjour », où « bonjour » est une chaîne de caractères passée en paramètre. Ici, comme le contenu est une chaîne de caractères, le paramètre est placé entre guillemets.

 

SayString ("Bonjour"+"Comment allez-vous")

Même si cela manque d’intérêt, nous avons passé 2 paramètres à l’intérieur de la fonction. Nous devons séparer les différents paramètres par le signe « Plus », dans ce cas, le signe « Plus » est appelé « Séparateur ». D’ailleurs, le fait de coller bout à bout plusieurs chaînes de caractères est une opération dite de « concaténation ».

Bien sûr, dans cet exemple, nous aurions pu écrire directement les 2 chaînes de caractères dans le même paramètre. Mais je voulais démontrer la possibilité de pouvoir introduire plusieurs paramètres dans la même fonction. Il suffit seulement d’utiliser le séparateur « Plus ». Ainsi, vous verrez plus tard qu’il sera possible de combiner ultérieurement, du texte, des variables et des constantes.

 

SayInteger :

 

La fonction SayInteger permet de lire la valeur entière passée en paramètre, un numérique.

 

SayInteger (14)

Comme il s’agit d’un numérique, le paramètre ne doit pas être encadré par des guillemets.

 

Des scripts et des fonctions de lecture à l’écran

 

SayCharacter ()

(Équivaut à l’emploi de la touche 5 du pavé numérique.)

 

SayPriorCharacter ()

(Équivaut à l’emploi de la touche 4 du pavé numérique.)

 

SayNextCharacter ()

(Équivaut à l’emploi de la touche 6 du pavé numérique.)

 

SayWord ()

(Équivaut à l’exécution du raccourci clavier Insère +5 du pavé numérique.)

 

SayPriorWord ()

(Équivaut à l’exécution du raccourci clavier Insère +4 du pavé numérique.)

 

SayNextWord ()

(Équivaut à l’exécution du raccourci clavier Insère +6 du pavé numérique.)

 

SayLine ()

(Équivaut à l’exécution du raccourci clavier Insère +8 du pavé numérique.)

 

SayPriorLine ()

(Équivaut à l’emploi de la touche 8 du pavé numérique.)

 

SayNextLine ()

(Équivaut à l’emploi de la touche 2 du pavé numérique.)

 

SayFromCursor ()

(Équivaut à l’exécution du raccourci clavier Insère +Page Précédente du pavé numérique, donc, Insère +9.)

 

SayColor ()

(Équivaut à l’exécution du raccourci clavier Insère +5 du pavé alphanumérique.)

 

SayFont ()

(Ce script équivaut à l’exécution du raccourci clavier Insère +F.)

 

PerformScript SayWindowTitle ()

(Ce script équivaut à l’exécution du raccourci clavier Insère +T.)

 

SayAll ()

(Équivaut à l’exécution du raccourci clavier Insère +2 du pavé numérique.

Ce script se nomme « dire tout »).)

Voir aussi SayToBottom…

 

SayField ()

Voir aussi SayChunk…

 

PerformScript SayWindowPromptAndText ()

(Équivaut à l’exécution du raccourci clavier Insère +TAB.)

 

Les fonctions d’épellation

 

SpellString ()

 SpelleString (« chaîne de caractères »)

Le paramètre peut être aussi une variable, une constante ou une fonction qui retourne une chaîne de caractères.

Par exemple,

Pour épeler le mot courant : SpellString (GetWord ())

Pour épeler la ligne courante : SpellString (GetLine ())

 

Allez, il faut que je vous le dise, il y a des fonctions pour réaliser directement ce travail !

 

SpellWord ()

(Équivaut à l’exécution du raccourci clavier Insère +(5 2 fois rapidement) du pavé numérique.)

 

SpellLine ()

(Équivaut à l’exécution du raccourci clavier Insère +(8 2 fois rapidement) du pavé numérique.)

Philippe BOULANGER