DESCRIPTION.

La commande système *KEY permet de redéfinir ce qui sera retourné par les touches fonctions et spéciales.

SYNTAXE.

*KEY code chaine

REMARQUES.

chaine doit être une chaine de caractères quelconque mais valide. Si chaine est omis, la touche du clavier associée à code retrouvera sa valeur par défaut.

chaine peut contenir le caractère d'échappement |, pour utiliser des caractères non imprimables. Par exemple : 

- |M, pour retourner un retour chariot (CR) ;

 - |?, pour retourner une suppression (DEL) ;

 - |", pour inclure un guillemet dans la chaine retournée ;

 - ||, pour retourner un caractère d'échappement lui-même ;

 - |!, pour retourner l'activation le bit 7 du caractère suivant ;

 - ... .

code doit avoir l'une des valeurs suivantes : 

- 1, pour la touche fonction F1 ;

- 2, pour la touche fonction F2 ;

- 3, pour la touche fonction F3 ;

- 4, pour la touche fonction F4 ;

- 5, pour la touche fonction F5 ;

- 6, pour la touche fonction F6 ;

- 7, pour la touche fonction F7 ;

- 8, pour la touche fonction F8 ;

- 9, pour la touche fonction F9 ;

- 10, pour la touche fonction F10 ;

- 11, pour la touche fonction F11 ou la combinaison de touches Shift + Tab ;

- 12, pour la touche ←, flèche vers la gauche ;

- 13, pour la touche →, flèche vers la droite ;

- 14, pour la touche ↓, flèche vers le bas ;

- 15, pour la touche ↑, flèche vers le haut ;

- 16, pour la combinaison de touches Ctrl + ←, ou molette de la souris vers le bas ;

- 17, pour la combinaison de touches Ctrl + →, ou molette de la souris vers le haut ;

- 18, pour la touche home, touche aller au début ;

- 19, pour la touche end, touche aller à la fin ;

- 20, pour la touche PgUp, touche retourner d'une page (écran) ;

- 21, pour la touche PgDn, touche descendre d'une page (écran) ;

- 22, pour la touche ins, touche d'insertion de caractère ;

- 23, pour la touche del, touche de suppression de caractère ;

- 24, pour la touche backspace, touche de retour arrière ;

Une fois redéfinie par l'appel de la commande système *KEY, l'appui sur cette touche retournera chaine.

L'utilisation de la commande système *KEY sera particulièrement pratique pour utiliser, et retourner, certains code ASCII, ou une combinaison de code ASCII, effectuant un commande. 

Note : la forme *KEY 24 |? renforcera la compatibilité avec certains programmes BBC Micro en redéfinissant la touche Backspace pour qu'elle renvoie le code 127 (DEL) au lieu de 8 (BS).

Si chaine est trop longue, une erreur Bad string se produira et la touche correspondante à code ne retournera que la partie de chaine qui pourra être insérée.

A la sortie de l'application, toutes les touches de fonction et d'édition retrouveront leur valeur par défaut.

Si le retour, que doit faire l'appui sur une touche, peut être différent selon l'endroit où se trouve l"exécution ou selon le choix de l'utilisateur, il est possible de redéfinir chaine en utilisant l'instruction OSCLI : OSCLI "KEY " + STR$code + " """  + chaine +"""". Voir l'instruction OSCLI pour plus de détails. 

EXEMPLE.

*KEY 1 vous avez appuyé sur F1