SCR/AL1 - TOME II. Les Objets - 10.3 Définition d'une OPTION d'A


Présentation	Documentation				L'équipe	Sérialisation
	Programmes	Objets	Libs Utilitaires	Libs Internes
	Editeur	Syntaxes	Windows	Versions

SCR/AL1 - TOME II. Les Objets

10. A_BAR

10.3 Définition d'une OPTION d'A_BAR

Les OPTIONS des A_BAR sont les têtes de chapitre de l'application. Contrairement aux OPTIONS des MENUS, elles doivent donner lieu à une ACTION, à un MENU ou à un retour.

"text"

Il s'agit du titre de l'OPTION. Ce titre sera séparé du précédent et du suivant par un blanc généré par SCR/AL1. La somme des longueurs des titres ne peut dépasser la largeur de l'écran.

MENU ou ACTION ou RETURN

L'un de ces trois mots-clés indiquent ce qui doit être exécuté lorsque l'OPTION courante est sélectionnée en pressant la touche ENTER. Le choix entre trois possibilités est permis :

MENU : indique que cette OPTION donne lieu à un sous-menu. Le mot-clé MENU sera suivi de la définition du sous-menu ou de son nom s'il est défini ailleurs.
ACTION : indique que cette OPTION donne lieu à l'exécution d'une ACTION dont le nom ou la définition est fourni à côté. Le mot-clé ACTION n'est pas requis : l'acollade ouvrante indique que ce qui suit est une ACTION.
RETURN : indique que l'édition de l'A_BAR doit se terminer lorsque cette OPTION est sélectionnée par la touche ENTER.

fnkey

Un nom de touche fonction peut être placé en regard d'une OPTION d'A_BAR. Cette touche fonction aura pour effet de quitter toute ACTION en cours et de revenir en édition de l'A_BAR sur l'OPTION correspondante. Si cette OPTION a un MENU associé, le MENU est affiché. Si l'OPTION exécute une ACTION, l'action est directement exécutée. Si l'OPTION effectue un RETURN, l'A_BAR est quittée.

DISPLAY_FN

Cette ACTION est exécutée à chaque fois que l'OPTION doit être affichée. S'il s'agit d'une fonction C et que le code retour de cette fonction est non nul, l'OPTION n'est ni affichée, ni sélectionnable.

De cette façon, il est possible de "cacher" une partie de l'application en fonctin par exemple des priorités d'accès d'un utilisateur.

Cela permet aussi de choisir un mode de travail (Beginner, Advanced) : suivant le mode de travail, certains point de l'A_BAR seront ou non visibles.

Exemple

    OPTION "Système" DISPLAY_FN {C_FN return(USER_CODE < 2);}

Cette option n'apparaîtra que si le code utilisateur est inférieur à 2.

HELP

Le mot-clé HELP doit être suivi du nom d'un sujet contenu dans le fichier d'aide actif (voir ACTION HELPFILE "filename").

Exemple

    HELP "Impressions"

Ce sujet sera affiché si, lors de l'édition de l'A_BAR, la touche HELP est appuyée par l'utilisateur sur cette OPTION.

Valeur par défaut

Par défaut, le HELP de l'A_BAR est affiché. S'il n'y en a pas, le premier sujet du fichier d'aide est affiché.

COMMENT

Les COMMENTS sont des textes (d'une ligne maximum) qui sont associés à des objets ou à des champs. Ils sont affichés automatiquement dans la fenêtre COMMENT définie dans l'application SCR/AL1. La syntaxe de définition de ces fenêtres se trouve dans le chapitre intitulé "Structure d'un fichier SCR/AL1".

Dès que l'OPTION est affichée, le texte acollé au mot-clé COMMENT est affiché dans la fenêtre. Il disparaît automatiquement au passage à l'OPTION suivante et est remplacé par le COMMENT de l'OPTION suivante ou par le COMMENT de l'A_BAR s'il n'y en a pas au niveau de l'OPTION.

Exemple

A_BAR ab_main {
    LINE 1 COL 2
    OPTION "Adresses"  ALT_A  COMMENT "Gestion des adresses" MENU {
        OPTION "Mise à jour des adresses"       {AB_edit_isam p_af_adr}
                COMMENT "Edition et mise à jour du fichier des adresses"
        OPTION "Consultation multi-adresses"    {MP_edit_isam amp_adr}
                COMMENT "Visualisation du fichier multi-record"
        OPTION "Impressions et statistiques"    {PG_edit adp_adr}
                COMMENT "Comptage et impression des adresses"
        }
 
    OPTION "Expéditions"  ALT_E         MENU {
        OPTION "Consultation/Mise à jour"   {PG_edit_isam p_af_lpubl}
        OPTION "Statistiques"               {C_FN Statistiques();}
        OPTION "Impressions Vade mecum"     {C_FN VadeMecum();}
        }
 
    OPTION "Références"  ALT_R   COMMENT "Fichiers de référence" MENU {
        OPTION "Codes de classification"{MP_edit_isam amp_class}
            COMMENT "Mise à jour du fichier des définitions de classes"
        OPTION "Code postaux"           {MP_edit_isam amp_post}
            COMMENT "Mise à jour du fichier des codes postaux"
        OPTION "Publications"           {MP_edit_isam amp_publ}
            COMMENT "Mise à jour du fichier des publications"
        OPTION "Titres"                 {MP_edit_isam amp_titre}
            COMMENT "Mise à jour du fichier des titres"
        OPTION "Préfixes"               {MP_edit_isam amp_pnom}
            COMMENT "Mise à jour du fichier des préfixes des noms"
        }
 
    OPTION "Misc"    ALT_M           MENU {
        auto back reverse
        OPTION "Aide                       F1"        {Record {ALT_H}}
            COMMENT "Accès au manuel on-line"
        OPTION "Infos/Verrouillage      ALT_Z"  ALT_Z {C_FN AD_passwd();}
            COMMENT "Page d'informations et de verrouillage"
        OPTION "Formatter une disquette"              {PG_edit adp_format}
            COMMENT "Formattage d'une disquette vierge"
        OPTION "Backup des données"                   {PG_edit adp_backup}
            COMMENT "Copie de sauvegarde sur disquette"
        OPTION "Exit                   ALT-X" ALT_X   {APPL_QUIT}
            COMMENT "Quitter l'application"
        }
}