DLGBOX

Sommaire

"Dlgbox"permet de déclarer une boîte s'appuyant sur un écran principal, avecdéclaration possible d'onglets, de listes gauches, et de boutons.

Syntaxe

[Local]Dlgbox
  fenêtreFromfonctionAtexp1Withexp2Maskmasque
   [Atposition]
   [ liste_folder]
   [ liste_bgauche]
   Asabrev

Paramètres

Elément	Description	Restrictions
fenêtre	Nomde la fenêtre
fonction	Nomde la fonction
exp1	chaînede caractère pour indiquer le timestamp
exp2	chaînede caractère pouvant prendre les 2 valeurs : "" "&SCR_PREVIEW"
masque	Identifiantdu masque principal sous l'une des formes suivantes -nom du masque [classe0 ] -classe0 - '='*expr_c* [ classe0 ]	classe0 désigne un masque. Lorsqu'elle est donnée seule, le masque doit être ouvert.
expr_c	Expressionalphanumérique dont le résultat est un nom de masque sous la forme d'unidentificateur ou d'un chemin absolu ou relatif.
position	Position de la boite de picking àl'écran sous la forme : '('*exp_lig* ','exp_col ')' '	Cette position ne doit pas être endehors de l'écran.
exp_lig	Expression numérique du numéro de ligneà l'écran, à partir duquel sera affichée la boite de picking. exprimé en 1/8 de ligne
exp_col	Expression numérique du numéro decolonne à l'écran, à partir duquel sera affichée la boite de picking. exprimé en 1/4 de colonne
liste_folder	Listed'onglets séparés par le caractère ','. La définition d'un onglet s'exprime sous la forme : Foldermaskmasque1 [Titledtitre_onglet]	8onglets maximum
masque1	Identifiantd'un onglet sous l'une des formes suivantes : -nom du masque [classe1 ] -classe1 -'='*expr_c* [ classe1 ]	classe1 désigne un masque. Lorsqu'elle est donnée seule, le masque doit être ouvert.
titre_onglet	Expressionalphanumérique du titre de l'onglet
liste_bgauche	listede fenêtre gauche séparée par le caractère ','. La définition d'une fenêtre s'exprime sous la forme : typ_boîte classe2 bgauche liste_champTitledtitre_bgauche	16maximum
typ_boîte	Listbox : listesimple Treebox : liste hiérarchisée Leftbox: picking simple Pickbox: picking hiérarchisé
classe2	abréviationdésignant la table sur laquelle s'appuie la liste de gauche
bgauche	Identifiantde la liste de gauche sous la forme : -nom de la listegauche
liste_champ	Listedes champs de la boîte de gauche séparés par le caractère ','. La définition d'un champ s'exprime sous la forme : champ [Titledtitre_champ]	lataille totale des champs ne doit pas dépasser 240 octets.
champ	Identifiantd'un champ sous l'une des formes suivantes : -nom du champ -expr_c
titre_champ	Expressionalphanumérique du titre du champ
titre_bgauche	Expressionalphanumérique du titre de la liste de gauche
abrev	abréviationdésignant la boîte

Exemples

# affichage d'une fenêtre
LocalDlgbox"OTMD" From GFONCTION At A_STAMP WithWINDPREV Mask [TMD1]
& Listbox [TMD_] GAU_CHE
& [F:TMD]MDL Titled TITSEL(1) ,
& [F:AXX]TEXTE Titled TITSEL(2)
& Listbox [TMD9] GAU_CHE9
& [F:TMD9]A_TAB1 Titled TITSEL9(1) ,
& [F:TMD9]A_TAB2 Titled TITSEL9(2)
& As [TMD1]
Titled [TMD1] TIT

Description et commentaires

"Dlgbox"permet de déclarer une boîte qui peut ne pas être pleine page. Elle s'appuiesur un écran principal. Cette boîte est identifiée par une abréviation que l'onutilisera pour afficher, saisir, effacer à l'écran ou supprimer de la mémoirela boîte, avec les instructions Boxact,Dlgbox, Boxclret Close Dlgbox.
C'est une fenêtre windows qui est indépendante.
la cause atpermet de préciser le timestamp de génération de la fenêtre.
La clause withest suivie d'une chaîne vide, ou de la chaîne "$SCR_PREVIEW" pour lapré-visualisation de la fenêtre.
Il est possible d'afficher dans cette boîte un seul masque, ou bien unmasque principal et des onglets (8 maximum).
Pour définir un onglet, on utilisera le mot clé Folder.
Il est possible de définir des listes de gauches (16 maximum). Les listes degauche peuvent être de différents types :
Listbox :Pour définirune liste de gauche simple. sélection d'un seul enregistrement.
Treebox :Pour définirune liste de gauche hiérarchisée. sélection d'un seul enregistrement.
Leftbox :Pour définirun picking simple. sélection de plusieurs enregistrements
Pickbox :Pour définirun picking hiérarchisé. sélection de plusieurs enregistrements
Pour la même boîte, il est possible de définir des listes de gauche detype différent.
La variable currind indique la clé utilisée par la liste gauche. Cette clédoit être unique. Suite à la sélection, la classe [F]est complètement chargée.
La variable Currbox sera alimentée par le nom de la liste gauche courante.

Remarques

Le nombre d'OBJets-écrans pouvant être ouverts simultanément est au pluségal à 25. On appelle OBJet-écran les boîtes ouvertes par Mesbox, Inpbox, Dlgbox, Listbox, Treebox, Pickbox (ycompris quand c’est une liste de gauche).Il faut aussi prendre encompte dans ce nombre la "fenêtre de travail" ouverte aulancement d'une application.
La déclaration d'un OBJet-écran avec une abréviation, déjà utilisée par unautre OBJet-écran, referme ce dernier.
L'instruction Close[Local]Dlgboxsupprime de la mémoire les boîtes ouvertes par [Local]Dlgbox. Si l'abréviation n'est pasprécisée, toutes les fenêtres ouvertes localement sont supprimées.
Lorsqu'un sous-programme se termine, les boîtes ouvertes par LocalDlgboxdans cesous-programme sont refermées comme si l'on avait fait CLoseDlgbox.

Erreurs associées

Erreur	Description
ERCLAS(7)	Classen'est pas une abréviation
ERMABR(37)	2masques avec même abréviation
ERMODE(10)	untitre n'est pas alphanumérique

Mots-clés associés

Inpbox - Mesbox - Boxact- Fillbox- Boxinp- Boxclr- Currbox- Status- Titled

Sommaire