KEY

Voir également

Programme les touches du clavier sur le client lourd.

Support client WebVue - Non applicable. Renvoie un code d'erreur si exécuté dans ce contexte.

Mode	Mnémonique	Syntaxe
1	ADDCLK	1
2	ADDSTD	2
3	ADDPROG	3
5	DEL	4
6	DELALL	5
11	ADDCLKS	1
12	ADDSTDS	2
13	ADDPROGS	3
21	DELSTD	6
22	DELCLK	7
23	DELPROG	8

Changements dans la gestion des touches de fonction à partir de la version 12

Avant la version 12, la configuration par défaut des touches de fonction avec des actions standard préconfigurées était créée automatiquement à chaque démarrage du logiciel PcVue. Toute modification effectuée dans le cadre de la configuration du projet était écrasée. Cela signifiait que si vous vouliez supprimer ou modifier la fonction de l'une de ces touches de façon permanente, il fallait utiliser un programme SCADA Basic conçu pour s'exécuter à chaque démarrage du logiciel PcVue.

À partir de la version 12, la configuration par défaut des touches de fonction avec des actions standard préconfigurées est créée une seule fois lors de la création du projet. Par conséquent, tout changement effectué ultérieurement, dans le cadre de la configuration du projet, est permanent.

Arguments communs à plus d'un mode

Argument	Définition
Modifiers	Description des modificateurs - Voir ci-dessous pour plus d'informations sur les valeurs possibles. Type STR
KeyCode	Code de la touche - Voir ci-dessous pour plus d'informations sur les valeurs possibles. Type INTEGER.
Activbit	Optionnel. Nom complet de la variable état ou alarme d'activation de l'événement. Type STR
ActiveConditionTo1	Optionnel. L'état auquel l'ActivBit doit être défini pour activer l'événement. 0 ou 1. La valeur par défaut est 1.
DellAllMode	Argument optionnel pour indiquer quelles touches fonctions doivent être supprimées, les temporaires créées par programme et/ou les permanentes créées par configuration. Type : INTEGER. 1 = Supprime uniquement les touches fonctions temporaires (valeur par défaut), 2 = Supprime uniquement les touches fonctions permanentes, 3 = Supprime à la fois les touches fonctions temporaires et les permanentes.

Syntaxe 1

IntVal = KEY(Mode, Modifiers, KeyCode, Window, Branch, Identity[, Activbit[, ActiveConditionTo1]]);

Type de retour : INTEGER.

Argument	Définition
Window	Nom de la fenêtre contenant la zone de contrôle. Type STR.
Branch	Nom de branche de la fenêtre contenant la zone de contrôle. Type STR.
Identity	Identifiant (ou repère) de l'animation (zone sensible) dans la fenêtre spécifiée. Type STR.

Exécution

Mode	Mnémonique	Action
1	ADDCLK	Programmation du déclenchement d'une zone sensible (commandable) d'une fenêtre. Annule et remplace le ADDCLK précédent sur la même touche (Modifiers+KeyCode).
11	ADDCLKS	Ajoute une autre fonction à une clé, sans supprimer aucune fonction précédente.
		Retour : 1 si OK, 0 sinon.

Syntaxe 2

IntVal = KEY(Mode, Modifiers, KeyCode, Action[, Activbit[, ActiveConditionTo1]]);

Type de retour : INTEGER.

Argument	Définition
Action	Code de la touche - Voir ci-dessous pour plus d'informations sur les valeurs possibles. Type INTEGER

Exécution

Mode	Mnémonique	Action
2	ADDSTD	Déclencher une action standard. Annule et remplace le déclenchement précédent sur la même touche.
12	ADDSTDS	Ajoute une autre fonction à une clé, sans supprimer aucune fonction précédente.
		Retour : 1 si OK, 0 sinon.

Syntaxe 3

IntVal = KEY(Mode, Modifiers, KeyCode, Program, Branch, Function[, farg[, Activbit[, ActiveConditionTo1]]]);

Type de retour : INTEGER.

Argument	Définition
Program	Nom du programme contenant la fonction. Type STR.
Branch	Nom de branche. Type STR.
Function	Nom de la fonction. Type STR.
Farg	Optionnel. Chaîne de 2 047 caractères maximum. Utilisé pour passer de 1 à 8 arguments (séparés par une virgule) à la fonction. Type STR.

Exécution

Mode	Mnémonique	Action
3	ADDPROG	Exécute une fonction depuis un programme. Si la fonction MAIN est utilisée alors ne pas utiliser d'instruction DELAY sinon les résultats seront imprévisibles.
13	ADDPROGS	Ajoute une autre fonction à une clé, sans supprimer aucune fonction précédente.
		Retour : 1 si OK, 0 sinon.

Syntaxe 4

IntVal = KEY( Mode, Modifiers, KeyCode, DelAllMode]);

Type de retour : INTEGER.

Exécution

Mode	Mnémonique	Action
5	DEL	Supprime le déclenchement du programme touche fonction. Retour : 1 si OK, 0 sinon.

Syntaxe 5

IntVal = KEY(Mode, DelAllMode]) ;

Type de retour : INTEGER.

Exécution

Mode	Mnémonique	Action
6	DELALL	Supprime toutes les actions de la touche de fonction spécifiée. Retour : 1 si OK, 0 sinon.

Syntaxe 6

IntVal = KEY(Mode, Modifiers, KeyCode, Window, Branch, Identity);

Type de retour : INTEGER.

Argument	Définition
Window	Nom de la fenêtre contenant la zone de contrôle. Type STR.
Branch	Nom de branche de la fenêtre contenant la zone de contrôle. Type STR.
Identity	Identifiant (ou repère) de l'animation (zone sensible) dans la fenêtre spécifiée. Type STR.

Exécution

Mode	Mnémonique	Action
21	DELCLK	Supprime le déclenchement de la zone nommée. Retour : 1 si OK, 0 sinon.

Syntaxe 7

IntVal = KEY(Mode, Modifiers, KeyCode, Action);

Type de retour : INTEGER.

Exécution

Mode	Mnémonique	Action
22	DELSTD	Supprime l'action spécifiée. Retour : 1 si OK, 0 sinon.

Syntaxe 8

IntVal = KEY(Mode, Modifiers, KeyCode, Program, Branch, Function);

Type de retour : INTEGER.

Argument	Définition
Program	Nom du programme contenant la fonction.
Branch	Nom de branche.
Function	Nom de la fonction.

Exécution

Mode	Mnémonique	Action
23	DELPROG	Supprime le déclenchement de l'action nommée. Retour : 1 si OK, 0 sinon.

Valeurs possibles pour l'argument Modifiers

Le paramètre Modifiers est une chaîne qui décrit les éléments modificateurs de la gestion d'une touche.

Valeur	Comportement
D	L'action est exécutée lorsque la touche est enfoncée (sinon l'action est exécutée au relâchement de la touche).
S	L'action est exécutée lorsque la touche et Maj (Shift) sont pressés ensemble.
C	L'action est exécutée lorsque la touche et Ctrl sont pressés ensemble.
A	L'action est exécutée lorsque la touche et Alt sont pressés ensemble.

Valeurs possibles Code pour l'argument KeyCode

Le paramètre KeyCode est un Integer représentant une touche du clavier.

Touche	Code de Touche de Fonction
F1	1
F2	2
F3	3
F4	4
F5	5
F6	6
F7	7
F8	8
F9	9
F10	10
F11	11
F12	12
F13	13
F14	14
F15	15
F16	16
Back space	17
Tab	18 Ne pas utiliser.
Enter	19 Ne pas utiliser.
Shift	20 Ne pas utiliser sauf comme modificateur.
Ctrl	21 Ne pas utiliser sauf comme modificateur.
Alt	22 Ne pas utiliser sauf comme modificateur.
Pause	23 Ne pas utiliser.
Esc	24
Space	25 Ne pas utiliser.
Page up	26
Page down	27
End	28
Home	29
Left arrow	30
Up arrow	31
Right arrow	32
Down arrow	33
Print	34 Ne pas utiliser.
Insert	35
Delete	36
Numlock	37 Ne pas utiliser.

Valeurs possibles Code pour l'argument Action

Le paramètre Action est un Integer représentant une action standard.

Id	Action standard correspondante
1	Aide en ligne
2	Connexion / Déconnexion
3	Comptes utilisateurs
4	Fenêtre suivante
6	Montrer le menu
7	Observateur d'événements
8	Cacher le menu
9	Programmes
10	Quitter l'application
11	Exports de données
12	Magnétoscope
19	Zone de commande
21	Fenêtre suivante
22	Fenêtre précédente
23	Zone suivante
24	Zone précédente
25	Première zone
26	Dernière zone
121	Sélecteur de variables
122	Rafraîchir l'écran
124	Gestion centrale de projet

Exemple

KEY(2,"D" ,2, 2); ' F2
KEY(2,"D" ,3, 3); ' F3
KEY(2,"D" ,4, 4); ' F4
KEY(2,"D" ,5, 5); ' F5
KEY(2,"D" ,6, 6); ' F6
KEY(2,"D" ,7, 7); ' F7
KEY(2,"D" ,8, 8); ' F8
KEY(2,"D" ,9, 9); ' F9
KEY(2,"DS",10, 10); ' F10
KEY(2,"D" ,11, 11); ' F11
KEY(2,"" ,27, 21); ' PageDn
KEY(2,"" ,26, 22); ' PageUp
KEY(2,"" ,32, 23); ' ArrowRt
KEY(2,"" ,33, 23); ' ArrowDn
KEY(2,"" ,30, 24); ' ArrowLt
KEY(2,"" ,31, 24); ' ArrowUp
KEY(2,"" ,29, 25); ' Home
KEY(2,"" ,28, 26); ' End