KEY

Syntaxe

Paramètres

Description

Cette commande permet de rendre programmable les touches de fonctions (F1, F2, F3,...).

Remarques

• Attribution de chaînes aux touches de fonction : L'espace réservé n est un nombre représentant la touche de fonction. Les valeurs de n sont comprises entre 1 et 10 pour les touches de fonctions et 30 et 31 pour les touches de fonctions F11 et F12 sur les claviers à 101 touches. Le paramètre exprChaine$ est une chaîne de caractères de 15 caractères maximum renvoyée lorsque la touche de fonction est enfoncée. Si l'expression de chaîne de caractères est plus longue que 15 caractères, les caractères supplémentaires sont ignorés.
• L'instruction KEY vous permet de désigner des fonctions spéciales de touche logiciel - des chaînes de caractères étant renvoyées lorsque vous appuyez sur les touches de fonction.
• L'affectation d'une chaîne de caractères nulle à une touche programmable désactive la touche de fonction en tant que touche programmable.
• Si le numéro de touche de fonction n'est pas dans l'intervalle correcte, le message d'erreur suivant s'affiche avec l'expression de chaîne de caractères de clef précédente conservée :

Illegal function call



• Affichage des attributions de touches programmables : Vous pouvez afficher des touches programmables avec les instructions KEY ON, KEY OFF et KEY LIST :

Instruction	Action
KEY ON	Affiche les six premiers caractères des valeurs de chaîne de caractères de touches programmables sur la ligne inférieure de l'écran.
KEY OFF	Efface l'affichage des touches programmables de la ligne du bas, rendant cette ligne disponible pour l'utilisation du programme. Il ne désactive pas les touches de fonction.
KEY LIST	Affiche toutes les valeurs des touches programmables à l'écran, les 15 caractères de chaque touche étant affichés.



• Si une touche programmable est enfoncée, l'effet est le même que si l'utilisateur tapait la chaîne de caractères associée à la touche programmable. Les instructions INPUT$, INPUT et INKEY$ peuvent tous être utilisés pour lire la chaîne de caractères produite en appuyant sur la touche écran.
• Le paramètre n est le numéro d'une touche de fonction, d'une touche de direction du curseur ou d'une touche définie par l'utilisateur. Les valeurs de n sont les suivantes :

Valeur	Touche
1 à 10	Les touches de fonction F1 à F10
11	↑
12	←
13	→
14	↓
15 à 25	Touches définies par l'utilisateur
30 à 31	Les touches de fonction F11 ou F12 sur les claviers 101 touches.



• Les touches ←, →, ↑ et ↓ se réfèrent aux touches de direction.
• Vous pouvez activer le recouvrement des touches combinées à l'aide d'une variante de l'instruction KEY :

KEY n, CHR$(keyboardflag) + CHR$(scancode)

Le paramètre n est compris entre 15 et 25 pour indiquer une touche définie par l'utilisateur. Le paramètre keyboardflag peut être n'importe quelle combinaison des valeurs hexadécimales suivantes :

Valeur	Touche
&H00	Aucun indicateur de clavier
&H01-&H03	L'une ou l'autre des touches Shift
&H04	Ctrl
&H08	Alt
&H20	NumLock
&H40	CapsLock
&H80	101 touches étendues du clavier




Vous pouvez ajouter les valeurs ensemble pour tester plusieurs états de décalage. Une valeur keyboardflag de &H12 testerait à la fois Ctrl et Alt enfoncées, par exemple.

• Étant donné que le recouvrement par touche suppose que les touches Shift de gauche et de droite sont identiques, vous pouvez utiliser &H01, &H02 ou &H03 pour indiquer une touche Shift. Le paramètre de code de balayage est un nombre identifiant l'une des 83 touchés à piéger, comme indiqué dans le tableau ci-dessous.

Touche	Code de touche en hexadécimal	Touche	Code de touche en hexadécimal	Touche	Code de touche en hexadécimal
ESC	01	CTRL	1D	Barre d'espacement	39
! ou 1	02	A	1E	CapsLock	3A
@ ou 2	03	S	1F	F1	3B
# ou 3	04	D	20	F2	3C
$ ou 4	05	F	21	F3	3D
% ou 5	06	G	22	F4	3E
^ ou 6	07	H	23	F5	3F
& ou 7	08	J	24	F6	40
* ou 8	09	K	25	F7	41
( ou 9	0A	L	26	F8	42
) ou 0	0B	: ou ;	27	F9	43
_ ou -	0C	" ou '	28	F10	44
+ ou =	0D	~ ou `	29	NumLock	45
←	0E	Shift de gauche	2A	ScrollLock	46
Tab	0F	| ou \	2B	Home ou 7	47
Q	10	Z	2C	↑ ou 8	48
W	11	X	2D	PgUp ou 9	49
E	12	C	2E	-	4A
R	13	V	2F	← ou 4	4B
T	14	B	30	5	4C
Y	15	N	31	→ ou 6	4D
U	16	M	32	+	4E
I	17	< ou ,	33	End ou 1	4F
O	18	> ou .	34	↓ ou 2	50
P	19	? ou /	35	PgDn ou 3	51
{ ou [	1A	Shift de droite	36	INS ou 0	52
} ou ]	1B	PrtSc ou *	37	Del ou .	53
Return	1C	Alt	38



• L'instruction KEY (n) ON active l'interception d'événement de touche programmable ou de touche de direction du curseur par une instruction ON KEY. Si vous spécifiez un numéro de ligne différent de zéro dans l'instruction ON KEY alors que le recouvrement est activé, le QBASIC ou QuickBASIC vérifie si vous avez appuyé sur KEY (n). Si tel est le cas, le QBASIC ou QuickBASIC exécute la clause GOSUB dans l'instruction ON KEY. Le texte étant normalement associé à une touche de fonction n'est pas saisi.
• Lorsque vous travaillez dans l'environnement, QBASIC ou QuickBASIC teste entre les instructions pour les pressions de touches. Dans les programmes autonomes, vous pouvez spécifier la vérification entre les lignes.
• L'instruction KEY (n) OFF désactive l'interruption d'événement; même si un événement a lieu, on ne s'en souvient pas. L'instruction KEY (n) STOP inhibe l'interruption d'événement; autrement dit, si vous appuyez sur la touche spécifiée, votre action est mémorisée et une interruption d'événement ON KEY est exécutée dès qu'une instruction KEY (n) ON est exécutée.

Voir également

Langage de programmation - QuickBASIC/QBasic - Référence de procédures et de fonctions - ON KEY GOSUB
Langage de programmation - BASICA/GWBASIC - Référence de procédures et fonctions - KEY