| 
Mots-clés SDD graphiques: MNUBAR <sans paramètres> Niveau format Indique que ce format est une Barre d'action sous la forme : ..................................................................... : Action1 Action2 Action3 .... : : ---------------------------------------------------------------- : : : : : : : :...................................................................: Ce format commence toujours ligne 1, occupe au maximum 12 lignes Le séparateur est géré par le système (ou mot-clé MNUBARSEP) A chaque action correspond un menu déroulant (PULLDOWN) associé. Ce format ne peut contenir qu'une seule zone (2Y 0 Input, L1xC2) à laquelle sont associés des menus déroulants via MNUBARCHC. |
|
MNUBARCHC (n° format-pulldown 'texte associé' &retour) Niveau zone, uniquement dans un format MNUBAR, conditionnable. n° représente le n° de l'action dans la barre et le n° reçu par le pgm. format-pulldown est le nom d'un format pulldown à afficher quand cette action est choisie (gérer par le système dans la plupart des cas) 'texte associé' représente le texte affiché dans la barre &texte est valide, et représente une variable (usage P) contenant le texte (il faudra alors obligatoirement traiter ce format par WRITE, avant l'affichage, afin de renseigner le texte) Dans tous les cas le texte peut contenir le caractère >, indiquant que le caractère à sa droite est un raccourci clavier et doit être souligné. Si vous souhaitez le caractère '>' en tant que caractère significatif, il faut le doubler (>>). &retour , qui sera vu plus loin, est facultatif. |
|
Exemple de barre d'action: A R BAR MNUBAR A ACTION 2Y 0I 1 2 A MNUBARCHC(1 P1 '>Fichier') A MNUBARCHC(2 P2 '>Editer') A MNUBARCHC(3 P3 '>Aide') A R P1 PULLDOWN ... A R P2 PULLDOWN ... A R P3 PULLDOWN ... Les menus déroulants sont traités comme des fenêtres. Avec la syntaxe vue plus haut, le système affiche automatiquement P1,P2,P3 suivant le choix utilisateur sans action programme (il est toujours en phase de lecture) |
|
Si vous souhaitez "avoir la main" entre le choix utilisateur et l'affichage du menu déroulant (pour renseigner une variable par exemple), vous devez utiliser &retour (définie dans le programme 2Y 0 usage H) A R BAR MNUBAR A ACTION 2Y 0I 1 2 A MNUBARCHC(1 P1 '>Fichier' &RT) A MNUBARCHC(2 P2 '>Editer' &RT) A MNUBARCHC(3 P3 '>Aide') A RT 2Y 0H Le système rend alors le contrôle à votre programme lors d'un choix utilisateur.(Fichier ou Editer) Votre programme doit lire (READ) le format BAR pour recevoir RT qui contient alors le N° de l'action choisie. (1 ou 2) Après renseignement des variables, VOUS DEVEZ écrire le menu déroulant CORRESPONDANT !! (P1 ou P2) Puis passer un ordre READ sur la barre d'action qui provoquera l'affichage. |
|
MNUBARSEP ((*COLOR xxx) (*DSPATR( xx) (*CHAR 'x')) Niveau format uniquement pour un format MNUBAR permet de personnaliser la ligne de séparation en dessous d'une barre d'action *COLOR définit la couleur (dft = bleue) *DSPATR définit l'attribut (dft = normal) *CHAR définit le carctère (dft = '_' ou une ligne pleine sur des terminaux semi-graphiques) MNUBARDSP Niveau format, permet l'affichage d'une barre d'action DEUX utilisations sont possibles 1/ ce mot-clé est associé à un format traditionnel |
|
sa syntaxe est alors: MNUBARDSP(BAR &action [&option]) Le format indiqué (BAR) est systématiquement affiché en même temps que ce format. Les mots-clé de recouvrement sont appliqués AVANT l'affichage de la barre d'action. (absence ou non de OVERLAY, etc) Il y a un OVERLAY implicite du format traditionnel sur la barre d'action (qui n'est jamais effacée), inutile de le codifier. &action indique une variable du format (2Y 0 usage H) permettant de recevoir l'action choisie par l'utilisateur sans effectuer de READ sur le format BAR. (0 si aucun choix) &option,(2S 0 usage H) si indiquée, permet de recevoir l'option choisie dans le menu déroulant (choix simple via SNGCHCFLD). 0 = aucun choix, x = option n° x choisie -1 = choix complexe (zones d'entrée, choix multiples, Etc), il faut alors lire le menu déroulant (READ), suivant le choix utilisateur |
|
2/ ce mot-clé est associé au format barre d'action. sa syntaxe est alors: MNUBARDSP(&option) le format barre barre d'action peut être traité en autonome (EXFMT) si ce format contient le Mot-clé OVERLAY cela permet d'afficher une barre d'action sur option utilisateur. écriture-lecture d'un format traditionnel contenant "F11 = Voir Menu." si 11 est ON, écriture-lecture du format BAR (la barre d'action se superpose au format) vous recevez directement l'action choisie (fait partie du menu) et l'option du menu déroulant (&option) vous pouvez retrouver la saisie utilisateur sur le format traditionnel via un read format. |
|
scénario 1 A R BAR MNUBAR A ACTION 2Y 0I 1 2 A MNUBARCHC(1 P1 '>Fichier') A MNUBARCHC(2 P2 '>Editer') A MNUBARCHC(3 P3 '>Aide') A R P1 PULLDOWN ... A R P2 PULLDOWN ... A R P3 PULLDOWN ... A R FMT MNUBARDSP(BAR &ACT &OPT) A ACT 2Y 0H A OPT 2S 0H ... Le pgm écrit et lit FMT, (BAR est SYSTEMATIQUEMENT affiché) il effectue un Traitement en fonction du contenu de ACT et OPT. |
|
scénario 2 A R BAR MNUBAR OVERLAY A MNUBARDSP(&OPT) A ACTION 2Y 0I 1 2 A MNUBARCHC(1 P1 '>Fichier') A MNUBARCHC(2 P2 '>Editer') A MNUBARCHC(3 P3 '>Aide') A OPT 2S 0H A R P1 PULLDOWN ... A R P2 PULLDOWN ... A R P3 PULLDOWN ... A R FMT CA11(11 'affiche barre') ... le pgm écrit et lit FMT, s'il reçoit 11 en fonction, il affiche et lit BAR, effectue un traitement en fonction de ACTION et OPT. s'il a besoin d'informations contenues dans FMT il doit le lire (READ). |
|
MNUBARSW([CAxx]) Niveau format ou niveau fichier Indique la touche de commande permettant de passer alternativement du format traditionnel à la barre d'action. la touche par défaut est F10. si ce mot-clé est indiqué niveau format, il est conseillé de le preciser à la fois sur la barre d'action et sur le format traditonnel. s'il est indiqué niveau fichier, il est ignoré si aucune barre d'action n'est affichée. MNUCNL([CAxx [indic-de-réponse]) Niveau format ou niveau fichier Indique la touche à utiliser pour annuler un menu déroulant. (dft = CA12) Si le curseur se trouve sur un format traditionnel, l'indicateur de réponse est mis on et le contrôle est rendu au programme. |
|
PULLDOWN(*SLTIND | *NOSLTIND) Niveau format Indique qu'un format est un menu déroulant (doit être associé à une barre d'action) *SLTIND indique que chaque choix simple sera précédé d'une zone de saisie (zone de saisie numérique ou bouton radio), c'est le défaut. *NOLSTIND indique que chaque choix be sera pas précédé d'une zone de saisie (le choix se fait en déplacant le curseur et la sélection avec la barre d'espacement), cette option est ignoré pour un terminal caractère relié à un contrôleur non graphique. Un format PULLDOWN est "vu" comme une fenêtre par le système, c'est lui qui calcule la taille à l'affichage. Il peut donc contenir tout ce qu'une fenêtre (mot-clé WINDOW) peut contenir. (variables I/O/B, constantes, choix simples et choix multiples) Il est effacé par l'affichage d'un format traditionnel ou d'une fenêtre avec RMVWDW.Une fenêtre sans RMVWDW sera superposée. |
|
SNGCHCFLD <sans paramètres> Associé à une variable 2Y 0 usage B indique que cette variable accepte différentes valeurs (choix) dont une seule peut être choisie. Sur une terminal caractère : 1. choix 1 2. choix 2 3. choix 3 La position de la variable (ligne X colonne) indique la position de la zone de saisie. Sur un terminel semi-graphique : 0 choix 1 (O représentant un bouton radio) O choix 2 O choix 3 Le premier boution radio sera placé aux positions indiquées. Ces possibilités (boutons radios, mais aussi cases à cocher) NE SONT PAS RESERVEES AUX MENUS DEROULANTS, elles sont valides sur tous les formats. |
|
En entrée le contenu de la variable représente le choix utilisateur. En sortie (renseigné par le pgm), le bouton radio correspondant sera pré-coché. CHOICE(n° 'texte' [*SPACEB]) Niveau zone, associé à SNGCHCFLD ou MLTCHCFLD n° indique le ,° associé à ce choix 'texte' indique le texte associé (placé à droite), même regle que le texte associé à un choix de barre d'action (MNUBARCHC) peut être une variable, contenir '>', etc .. *SPACEB indique qu'entre ce choix et le précedent, vous souhaitez une ligne blanche. exemple: résultat SEL 2Y O B 13 45 SNGCHCFLD | 0 choix 1 CHOICE(1 'choix >1) | O choix 2 CHOICE(2 'choix >2') | CHOICE(3 'choix >3' *SPACEB | O choix 3 |
|
CHCACCEL('texte')
Niveau zone, associé à SNGCHCFLD dans un format PULLDOWN
définit le texte indiquant l'accélérateur (touche de commande) associé
à cette option du menu déroulant.
La touche de commande doit être définit (CA/CF) sur le format traité
par le pgm, qui recevera l'indicateur de réponse en fonction.
CHCCTL(n° &ctl [id-msg [bib/msgf]])
ou [&id-msg [&bib/&msgf]])
contrôle la validité d'une sélection via le contenu de CTL (1Y 0 usage H)
SNGCHCFLD 0 = valide | MLTCHCFLD 0 = valide non cochée.
| 1 = valide, pré-cochée
2 = invalide | 2 = invalide
les coordonnées message indiquent le message à afficher si l'utilisateur
choisi une sélection invalide.
|
|
MLTCHCFLD <sans paramètres> Niveau zone, se déclare en partie comme SNGCHCFLD. Indique un groupe de cases à cocher, chaque choix (CHOICE) peut être sélecté (coché) ou non. Vous DEVEZ associer le mot-clé CHCCTL à chaque choix afin de récuperer la saisie utilisateur: 0 = non coché 1 = coché CHCAVAIL((*COLOR xxx) (*DSPATR xx)) Niveau zone, associé à SNGCHCFLD ou MLTCHCFLD Définit les caractèristiques (couleur attribut) d'une sélection valide CHCUNAVAIL((*COLOR xxx) (*DSPATR xx)) Niveau zone, associé à SNGCHCFLD ou MLTCHCFLD Définit les caractèristiques (couleur attribut) d'une sélection invalide CHCSLT((*COLOR xxx) (*DSPATR xx)) Niveau zone, associé à SNGCHCFLD ou MLTCHCFLD Définit les caractèristiques (couleur attribut) d'une sélection choisie |
|
Autres mots-clés: HLPARA qui maintenat accepte la syntaxe suivante : HLPARA(*FLD nom-zone) permettant de définir une aide fonction d'une zone (son nom) et nom plus de sa position à l'écran. posséde une extension pour les choix SNGCHCFLD et MTLCHCFLD et MNUBAR HLPARA(*FLD nom-zone n°) nom-zone est la variable à laquelle est associé le mot-clé SNGCHCFLD ou MLTCHCFLD ou la variable d'un format MNUBAR n° représente un des choix possibles (mot-clé CHOICE ou MNUBARCHC) |
