INPBOX

Sommaire

"Inpbox"permet de déclarer une boîte pleine page s'appuyant sur un écran principal,avec déclaration possible d'onglets, de listes gauches.

Syntaxe

[Local]Inpbox
  fenêtreFromfonctionAtexp1Withexp2Maskmasque
   [ 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.
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 dé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 boite 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

# déclaration d'une fenêtre
Local Inpbox"OTMD" From GFONCTION At A_STAMP With WINDPREV 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

"Inpbox"permet de déclarer une boîte pleine page s'appuyant sur un écran principal.Cette boîte est identifiée par une abréviation que l'on utilisera pourafficher, saisir, effacer à l'écran ou supprimer de la mémoire la boîte , avecles instructions Boxact,Inpbox, Boxclret Close Inpbox.
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, Leftbox, Treebox,Pickbox (y compris quand c’est une liste de gauche).Il faut aussiprendre en compte dans ce nombre, la "fenêtre de travail"ouverte au lancement 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]Inpboxsupprime de la mémoire les boîtes ouvertes par [Local]Inpbox. 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 LocalInpboxdans cesous-programme sont refermées comme si l'on avait fait CLoseInpbox.

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

Dlgbox - Mesbox - Boxact- Fillbox- Boxinp- Boxclr- Currbox- Currind- Status- Titled

Sommaire