GETARG
Récupération des paramètres du contexte d'appel d'une fonction.
Support WebVue - Oui.
|
Mode |
Mnémonique |
Syntaxe |
Retour |
| 0 | MAINBRANCH | 1 | STR |
| 1 | ARG1 | 1 | STR |
| 2 | ARG2 | 1 | STR |
| 3 | ARG3 | 1 | STR |
| 4 | ARG4 | 1 | STR |
| 5 | ARG5 | 1 | STR |
| 6 | ARG6 | 1 | STR |
| 7 | ARG7 | 1 | STR |
| 8 | ARG8 | 1 | STR |
| 10 | SOURCE | 1 | STR |
| 11 | PROGRAM | 1 | STR |
| 12 | BRANCH | 1 | STR |
| 13 | FUNCTION | 1 | STR |
| 14 | WINDOW | 1 | STR |
| 15 | WBRANCH | 1 | STR |
| 16 | IDENTIFIER | 1 | STR |
| 17 | VARNAME | 1 | STR |
| 18 | VARVALUE | 1 | SINGLE |
| 19 | VARSTATUS | 1 | INTEGER |
| 20 | KEYTYPE | 1 | STR |
| 21 | KEYCODE | 1 | INTEGER |
| 22 | CRONTYPE | 1 | INTEGER |
| 23 | CRONDATE | 1 | STR |
| 24 | CRONTIME | 1 | STR |
| 25 | ARG9 | 1 | STR |
| 26 | ARG10 | 1 | STR |
| 27 | ARG11 | 1 | STR |
| 28 | ARG12 | 1 | STR |
| 29 | WEB | 1 | INTEGER |
| 30 | TS_VALUE | 1 | DOUBLE |
| 31 | TS_TYPE | 1 | INTEGER |
| 32 | VARVALUE_REGISTER | 1 | DOUBLE |
| 33 | VARVALUE_BIT | 1 | INTEGER |
| 34 | VARVALUE_ALARM | 1 | INTEGER |
| 35 | VARVALUE_TEXT | 1 | STR |
| 19 | GETREGION | 1 | INTEGER |
Les modes ARG1 à ARG16 supporte l'utilisation de caractères de substitution. Voir la rubrique Utilisation de Chaînes de Substitution dans une Animation pour plus d’informations.
Syntaxe 1
RtnVal = GETARG(Mode);
Voir tableau ci-dessus pour les types de retour.
Exécution
|
Mode |
Mnemonique |
Action |
|
0 |
MAINBRANCH
|
Renvoie la branche du programme qui contient la fonction d'où l'appel à GETARG est effectué, c'est-à-dire la branche avec laquelle le programme a été chargé. |
|
1-8 |
ARG1 to ARG8 |
Renvoie respectivement du 1er au 8ème champ contenu dans le paramètre d'appel. |
|
25-28 |
ARG9 to ARG12 |
Renvoie respectivement du 9ème au 12ème champ contenu dans le paramètre d'appel qui se trouve dans : Le champ de l'argument peut être spécifié en utilisant : CYCLIC |
|
10 |
SOURCE |
Renvoie une chaîne identifiant l'origine de l'appel de la fonction : CYCLIC |
|
11 |
PROGRAM |
Renvoie le nom du programme courant. |
|
12 |
BRANCH |
Renvoie la branche passée en argument à la fonction courante. |
|
13 |
FUNCTION |
Renvoie le nom de la fonction courante. |
|
14 |
WINDOW |
Retourne le nom de la fenêtre depuis laquelle l'appel a été effectué. Renvoie le repère de l'animation de type forçage programme ou d'une action associée à une alarme ou à une animation tableau. |
|
15 |
WBRANCH |
Retourne le nom de la branche de la fenêtre, comme en Mode 14. |
|
16 |
IDENTIFIER |
Renvoie le repère de l'animation de type forçage programme ou d'une action associée à une alarme ou à une animation tableau. |
|
17 |
VARNAME |
Renvoie le nom de la variable qui a changée de valeur dans le cas d'un EVENT. |
|
18 |
VARVALUE |
Renvoie la nouvelle valeur de la variable qui a changée dans le cas d’un EVENT si la variable est de type état, alarme ou mesure. Ce mode ne peut pas être utilisé pour les variables de type texte. |
|
19 |
VARSTATUS |
Renvoie : Le status de la variable de déclenchement, si la SOURCE est un EVENT. 1 si la variable est valide, 0 si la variable est invalide. La région d'appel, si la SOURCE est un Synoptique ou Array_Select. Cet usage est obsolète, utilisez le mode GETREGION à la place. Type de retour : INTEGER. |
|
20 |
KEYTYPE |
Renvoie le type de programmation de touche "Down/Shift/Control" dans le cas d'un KEY. |
|
21 |
KEYCODE |
Renvoie le code de la touche enfoncée dans le cas d'un KEY. |
|
22 |
CRONTYPE |
Renvoie le type de programmation horaire dans le cas d'un CRONTAB : ONCE |
|
23 |
CRONDATE |
Renvoie la date ou le jour du déclenchement horaire selon le type dans le cas d'un CRONTAB. |
|
24 |
CRONTIME |
Renvoie l'heure ou la minute du déclenchement horaire selon le type dans le cas d'un CRONTAB. |
|
29 |
WEB |
Renvoie un flag pour indiquer l'accès : 0 = Utilisateur local Différent de zéro = Client WebVue (utilisant une animation Forçage Programme). |
| 30 | TS_VALUE | Renvoie l'horodate UTC représentée par le nombre de millisecondes depuis 1980 dans le cas d'un EVENT. L'instruction DATETIMESTRING peut être utilisée pour la conversion en chaîne de caractères. |
| 31 | TS_TYPE |
Retourne la valeur de la variable de type texte dans le cas d'un EVENT.
0 = Horodatage par le logiciel PcVue.
|
| 32 | VARVALUE_REGISTER |
Retourne la valeur de la variable de type mesure dans le cas d'un EVENT. Notez que la valeur est retournée sous forme de DOUBLE. |
| 33 | VARVALUE_BIT |
Retourne la valeur de la variable de type état dans le cas d'un EVENT : 1 = On |
| 34 | VARVALUE_ALARM |
Retourne la valeur de la variable de type alarme dans le cas d'un EVENT : 0 = Disparue acquittée |
| 35 | VARVALUE_TEXT |
Retourne la valeur de la variable de type texte dans le cas d'un EVENT. |
| 19 | GETREGION | Retourne la région où l'animation est située dans le contexte d'un appel depuis un Synoptique ou Array_Select. |
Exemple
Voir tableau ci-dessus pour les types de retour.