SCR/AL1 - TOME IV. Les librairies internes
2. La librairie scr4o
2.6 Fonctions d'affichage des PAGES
2.6.10 PG_edit (file s_edpg.c:81)
Syntax
PG_edit(pg)
PAGE *pg;
Description
Edite une PAGE (sans l'afficher). Le processus est le suivant :
- Exécution de la BEGIN_FN de la PAGE. En cas de code retour non nul, l'édition n'a pas lieu.
- EDIT : Edition d'un champ éditable de la PAGE (voir PG_edit_field())
- Si une touche fonction globale a été pressée ou si l'édition du champ se termine par une ACTION ABORT, fin de l'édition
- Calcul du champ suivant à éditer. Si une touche fonction a été utilisée pour quitter le champ, aller en FIN. Si le champ qui vient d'être édité est le dernier de la PAGE et que WRAP est OFF, aller à FIN. Dans les autres cas, aller à EDIT.
- FIN : si un des champs est REQUIRED mais vide, aller en édition de ce champ. Sinon, exécution de la END_FN de la PAGE. Si celle-ci retourne une valeur non nulle, retour en édition.
Exemple
PG_display_im(pg);
PG_edit(pg);
...
PG_undisplay(pg);
Valeur retournée
- 0 en cas de fin d'édition normale
- -1 si pas de champ éditable
- -2 si Abort
- -3 si la Begin_FN retourne une valeur non nulle
- -4 si PAGE indéfinie
Voir également
PG_edit_window()