|
|
|
WADELIA |
|
|
|
|
(I) (C) |
|
Paragraphe d'utilisation
Syntaxe
L'objet est placé à l'extérieur d'une liste ou table liste :
RECUP_VAL_FORM ObjetGraphique VariableResultat.
ObjetGraphique |
→ |
Objet graphique ayant une propriété VALEUR modifiable via son interface graphique |
VariableResultat |
→ |
Variable de même type Adélia que la propriété VALEUR du paramètre ObjetGraphique |
L'objet est placé à l'intérieur d'une liste ou table liste :
RECUP_VAL_FORM ObjetListe NumLigne InfoCol VariableResultat.
ObjetListe |
→ |
Objet graphique ayant une propriété LISTE |
VariableResultat |
→ |
Variable de même type Adélia que la propriété VALEUR du paramètre ObjetGraphique |
InfoCol |
→ |
ObjetColonne | *SELECT | *MODIF |
ObjetColonne |
→ |
Objet graphique défini comme colonne de la liste de ObjetListe. Cet objet graphique doit avoir une propriété VALEUR modifiable via son interface |
*MODIF |
→ |
Indique que l'on veut récupérer l'état modifié de la ligne de numéro NumLigne |
*SELECT |
→ |
Indique que l'on veut récupérer l'état sélectionné de la ligne de numéro NumLigne |
VariableResultat |
→ |
Si le troisième paramètre est ObjectColonne alors VariableResultat contient la valeur de ObjectColonne pour la ligne de numéro NumLigne. VariableResultat doit être de même type Adélia que la propriété VALEUR du paramètre ObjetColonne.
Si le troisième paramètre est *SELECT alors VariableResultat vaut *VRAI si la ligne de numéro NumLigne est à l'état sélectionné. VariableResultat doit être de type Adélia BOOL.
Si le troisième paramètre est *MODIF alors VariableResultat vaut *VRAI si la ligne de numéro NumLigne est à l'état modifié. VariableResultat doit être de type Adélia BOOL. |
Description
Cet ordre permet de récupérer la valeur saisie par l'utilisateur dans un objet graphique avant l'exécution du traitement associé à l'événement Adélia déclenché par l'utilisateur. La valeur de l'objet ObjetGraphique ou ObjetColonne est affectée à la variable VariableResultat.
Remarque : Les objets graphiques ObjetGraphique / ObjectListe / ObjectColonne doivent appartenir au formulaire HTML qui est à l'origine de l'événement Adélia déclenché par l'utilisateur.
Cet ordre met à jour le mot réservé *CODE_RETOUR :
0 (*NORMAL) : L'opération s'est déroulée correctement.
1 : L'opération ne s'est pas déroulée correctement (erreur interne).
2 : Le contexte d'exécution est associé à un événement sans validation. Dans ce cas, le paramètre en sortie VariableResultat n'est pas renseigné.
3 : L'objet graphique ObjetGraphique, ObjListe ou ObjetColonne n'appartient pas au formulaire HTML qui est à l'origine de l'événement Adélia déclenché par l'utilisateur.
Par exemple
Soit un programme PGM_A qui affiche un compteur initialisé à 1 dans un objet champ de saisie CHS_CPT et pouvant être incrémenté lors d'un clic sur un objet bouton BTN_1 (de libellé "Incrémenter").
|
Action |
Page résultat de l'action dans le navigateur |
Etat du programme |
Bloc ANNULATION |
||
|
Saisie de l'URL de PGM_A (A1) |
Incrémenter |
CHS_CPT : 1 |
|
||
Clic sur BTN_1 (A2) |
Incrémenter |
CHS_CPT : 2 |
|
|||
Clic sur bouton Précédent |
Incrémenter |
CHS_CPT : 1 |
Dans le bloc ANNULATION :CHS_CPT vaut 1. L'appel à RECUP_VAL_FORM CHS_CPT CPT fixe 1 comme valeur de la variable CPT. |
|||
Saisie de 3 et clic sur BTN_1 (A2) |
Incrémenter |
CHS_CPT : 4 |
|
|||
Clic sur bouton Précédent |
Incrémenter |
CHS_CPT : 1 |
Dans le bloc ANNULATION :CHS_CPT vaut 1. L'appel à RECUP_VAL_FORM CHS_CPT CPT fixe 3 comme valeur de la variable CPT. |
Soit un programme PGM_A qui contient une liste TBL_PANIER d'articles à commander avec trois colonnes CHO_ARTICLE (désignation), CHS_QT (quantité) et BTN_MODIF (de libellé Modifier) qui permet sur un clic de modifier la quantité d'un article à commander.
La modification des quantités se fait directement en BD en parcourant la liste pour trouver la ligne modifiée (LECTURE_LST *MODIF).
|
Action |
Page résultat de l'action dans le navigateur |
Etat du programme |
Bloc ANNULATION |
|||||||||
|
Saisie de l'URL de PGM_A (A1) |
|
TBL_ARTICLE : Ligne 1 : "Stylo", 2 Ligne 2 : "Crayon", 1 *SELECT : 0 *MODIF : 0
|
|
|||||||||
Saisie de "3" crayon puis clic sur BTN_MODIF (A2) |
|
TBL_ARTICLE : Ligne 1 : "Stylo", 2 Ligne 2 : "Crayon", 3 *SELECT : 0 *MODIF : 0
|
|||||||||||
Clic sur bouton Précédent |
|
(*1) TBL_ARTICLE : Ligne 1 : "Stylo", 2 Ligne 2 : "Crayon", 1 *SELECT : 0 *MODIF : 0 |
Dans le bloc ANNULATION : CHS_QT vaut 1 pour la ligne 2.
L'appel à RECUP_VAL_FORM TBL_ARTICLE 2 CHS_QT ART_QT fixe 3 comme valeur de la variable ART_QT.
L'appel à RECUP_VAL_FORM TBL_ARTICLE 2 *MODIF LIG_MODIF fixe *VRAI comme valeur de la variable LIG_MODIF.
|
||||||||||
(*1) Restauration de la sauvegarde associée à l'action A1 suite à la demande d'annulation de A2.