Field
"Field" permet de définir des éléments dans la liste des champs et variables de l'éditeur de formule.
Syntaxe
Fieldabrev icône, elt_mère, elt_fille, libellé, aide, result
Paramètres
Elément | Description | Restrictions |
abrev | abréviation désignant la boîte ouverte pour l'éditeur de formule | 240 caractères max. pour l'ensemble des paramètres. |
icône | Expression numérique dont le résultat est un numéro d'icône. | valeur comprise entre 0 et 30. |
elt_mère | Expression alphanumérique dont le résultat est un identificateur de l'élément mère |
|
elt_fille | Expression alphanumérique dont le résultat est un identificateur de l'élément fille |
|
libellé | Expression alphanumérique dont le résultat est le libellé qui sera affiché dans la liste des champs et variables |
|
aide | Expression alphanumérique dont le résultat est le nom de la page HTML à affiché pour l'aide |
|
result | Expression alphanumérique qui sera inséré dans la formule si l'élément est sélectionné |
|
Exemples
#- Initilisation de la formule et ouverture de l'éditeur de formule
FORMULE = "date$"
Formula FORMULE As [FML]#- Déclaration des éléments :
#- la table ITMMASTER en 1er niveau
#- les champs ITMREF, ITMDES, ITMSHO en 2ème niveau
#- dans la liste des champs et variables
Field [FML] 4, "", "ITMMASTER", "Table ITMMASTER", "", ""
Field [FML] 4, "ITMMASTER", "ITMMASTER.ITMREF_0", "Référence
article", "", "[F:ITM]ITMREF"
Field [FML] 4, "ITMMASTER", "ITMMASTER.ITMDES_0", "Description
article", "", "[F:ITM]ITMDES"
Field [FML] 4, "ITMMASTER", "ITMMASTER.ITMSHO_0", "Intitulé abrégé",
"", "[F:ITM]ITMSHO"#- Affichage de l'éditeur de formule
Boxact [FML]$SAISIE
#- Saisie dans l'éditeur de formule
Boxinp [FML] Using REPONSE, FORMULE
Case REPONSE
When 1 : Gosub VERIFICATION : Goto FIN
When 46 : Gosub VERIFICATION
When 7 : Goto FIN
When Default :
Endcase
Goto SAISIE#- Vérification de la structure correcte de la formule -#
$VERIFICATION
E = abs(parse(FORMULE))
If E
Errbox errmes$(E)+chr$(13)+errm
Endif
Return$FIN
#- Fermeture de la boite
Boxclr [FML]
Close Local Inpbox [ZI1]
Close Local File [ZI1]
End
Description
"Field" permet de définir des éléménts dans la liste des champs et variables de l'éditeur de formule. Puisqu'il s'agit d'une liste hiérarchisée, on utilisera cette instruction "Field" pour définir chaque élément quelqu'en soit le niveau hiérarchique.
Le paramètre abrev permet d'identifier la boîte ouverte pour l'éditeur de formule.
Le paramètre icône permet d'affecter une icône pour l'élément déclaré. Cette icône est souvent choisie en fonction du niveau hiérarchique de l'élément. Si la valeur est 0, aucune icône ne sera affichée.
Le paramètre elt_mère est l'identificateur de l'élément de niveau hiérarchique supérieur auquel l'élément courant se rattache. Ce paramètre sera donc laissé à vide pour tous les éléments du 1er niveau hiérarchique.
Le paramètre elt_fille est l'identificateur de l'élément courant.
Le paramètre libellé contient le libellé qui sera affiché dans la liste des champs et variables pour l'élément courant.
Le paramètre aide est l'identificateur de la page HTML. Cette aide sera automatiquement affichée au bas de la boîte, lorsque l'élément est sélectionné et que la case à cocher "afficher l'aide" est positionnée. L'aide est recherchée dans le répertoire FLD qui est réservée à l'aide sur champ.
Le paramètre result contient l'expression qui sera insérée dans la formule lorsque l'élément est sélectionné. Le caractère % n'est pas inséré dans la formule mais, permet de positionner le curseur à cet endroit de l'expression dans l'éditeur de formule.
Les statuts retournés suite à une saisie dans l'éditeur de formule sont :
Statuts
Cas d'emploi
1
retouné par l'activation du bouton "OK"
7
retouné par l'activation du bouton "ANNULER"
46
retouné par l'activation du bouton "VERIFIER"
47
retourné par click sur élément mère sans élément fille
permet de générés les éléments fille.
Remarques
Pour la saisie d'une formule, il est préférable d'appliquer le type de donnée AFR sur le champ. Ce type de donnée permet d'accéder à l'éditeur de formule dans le menu contextuel du champ et de contrôler la syntaxe de la formule saisie. 5 tables peuvent être passées en paramètre afin d'alimenter la liste des champs et variables de l'éditeur de formule.