Bloc d'annulation d'événement ANNULATION
Remarque : Ce paragraphe n'est disponible que pour les programmes WADELIA Interactifs créés avec le support des boutons Précédent / Suivant du navigateur activé.
Le paragraphe ANNULATION permet d'annuler le traitement associé à un événement Adélia. Seuls les événements réversibles peuvent être annulés.
Ce paragraphe est exécuté lorsque l'utilisateur clique sur le bouton Précédent du navigateur. Dans ce contexte d'exécution, le programme se trouve dans l'état qu'il avait avant le déclenchement de l'événement à annuler : ce bloc sert donc à mettre à jour les données hors de la portée du programme (comme les données stockées en base de données par exemple), pour que celles-ci restent dans un état cohérent.
Exemple : Si un programme Adélia Web manipule un objet Table liste servant à l'affichage d'une table BD et qu'un événement Adélia crée une nouvelle ligne dans la Table liste et ajoute son contenu en BD, alors le bloc ANNULATION doit servir à supprimer en BD la ligne crée. Il n'est pas nécessaire de supprimer la ligne dans la liste de l'objet Table liste puisque l'état de l'objet Table liste à été sauvegardé par le système.
Comme ce paragraphe est lié à un contexte de PAGE, il ne permet d'annuler que les événements définis dans la page.
Pour distinguer l'action à annuler, le développeur doit utiliser les mots réservés *OBJ_ORIGINE et *EVT_ORIGINE. Ces mots réservés permettent respectivement de connaître le nom de l'objet ayant déclenché l'événement ainsi que le nom de l'événement à annuler.
Pour récupérer les valeurs des objets graphiques saisies par l'utilisateur avant le traitement de l'action à annuler, le développeur doit utiliser l'ordre RECUP_VAL_FORM.
Pour rappel, il n'est pas nécessaire dans ce bloc de traiter l'annulation de traitement lié à un événement irréversible ou muet.
Attention : Dans ce bloc, il est interdit de sortir de la page courante donc les traitements associés ne doivent pas utiliser les ordres TRAITER_XXX.
Exemple de traitement dans le bloc ANNULATION :
si *OBJ_ORIGINE = 'BTN_CREER'
* Annuler la création
sinon_si *OBJ_ORIGINE = 'CHS_NOM'
si *EVT_ORIGINE 'ONCHANGE'
* Annuler la nouvelle saisie d'un nom
sinon_si *EVT_ORIGINE = 'ONFOCUS'
* Annuler le traitement sur la prise de focus du champ nom
fin
sinon_si *OBJ_ORIGINE = 'CHS_PAYS' et *EVT_ORIGINE = *P_GUIDE
* Annuler le traitement fait dans le paragraphe GUIDE
fin
Accéder au source
Positionne le curseur au début du bloc correspondant dans le source.
Supprimer
Supprime le source dans le paragraphe.