LEC-VBA
BUT
Cette fonction permet de récupérer le contexte (type, format, valeur) de certaines variables de bases d’un pointeur d’une nomenclature de pointeur, ceci lors du déroulement de la génération d’une nomenclature de pointeurs DIAPASON.
Cette fonction est disponible uniquement pour les requêtes de type RN1 et RN5 et ne concerne que les variables de type VBA qui ne sont pas des tableaux.
TYPE
CARACTERE (rubrique fonction gestion ; libellé : Lecture VBA)).
SYNTAXE
Variable = LEC-VBA ( ACTION = REC-TYPE,REC-FORMAT,REC-VALEUR-LOC
REF-POINTEUR=Pointeur
TYPE-VARIABLE = VBA (non saisi)
NOM-VARIABLE = Référence de la variable VBA traitée
E-S :VALEUR = valeur liée à l’action de la fonction)
PARAMETRES
Paramètre | E/S | O | Type | Description |
ACTION | E | Oui | Caractère | REC-TYPE : cette action demande à DIAPASON de donner le type (Caractère, Numérique, Date, Logique) de la variable définie dans le paramètre NOM-VARIABLE. Le type est retourné dans la variable du paramètre entrée-sortie VALEUR. REC-FORMAT : cette action demande à DIAPASON de donner le format de la variable définie dans le paramètre NOM-VARIABLE. Le format est retourné dans la variable du paramètre entrée-sortie VALEUR. REC-VALEUR-LOC : cette action demande à DIAPASON de rechercher la valeur de la variable VBA définie dans le paramètre NOM-VARIABLE. La valeur est retourné dans la variable du paramètre entrée-sortie VALEUR. La valeur est recherchée exclusivement sur le pointeur donné dans le paramètre correspondant. |
POINTEUR | E | Oui | Caractère | Référence pointeur. Donné sous la forme de variable ou de constante. La valeur doit correspondre à une valeur de pointeur déjà généré mémorisé dans la variable VBA.ge-ref-ptr lors de la génération d’un pointeur. |
TYPE-VARIABLE | E | Oui | Caractère | Type DIAPASON de variable. Non saisi, forcé à VBA |
NOM-VARIABLE | E | Oui | Caractère | Nom de la variable VBA dans le dictionnaire des variables DIAPASON. |
VALEUR | E | Oui | Caractère | Valeur en entrée ou sortie de fonction dépendant du paramètre ACTION. |
EXEMPLE
L’instruction qui suit permet de mémoriser dans la variable locale Valeur la valeur
effective (au format caractère exclusivement) de la variable VBA dont le nom est le contenu de la variable locale Nom et dont le pointeur est le contenu de la variable locale Contexte :
VLO.Fct = LEC-VBA( ACTION= REC-VALEUR-LOC, REF-POINTEUR = VLO.Pointeur, TYPE-VARIABLE=VBA , NOM-VARIABLE= VLO.Nom , E-S:VALEUR= VLO.Valeur )
NOTES
La génération des nomenclatures de pointeurs est réalisée niveau par niveau de nomenclature ; lors de la génération d’un pointeur, la variable SCR.NomPtrGen contient la référence du pointeur en cours de génération qui sera mémorisée dans la variable VBA.ge-ref-ptr si le pointeur est généré.