Accès aux propriétés des objets
Les objets enregistrés dans la base de données du projet, tels que les documents ou les graphiques, possèdent une série de propriétés. Par exemple, chaque objet a un nom ou une date de création ; les ensembles de données ont une unité physique, etc. Vous pouvez utiliser FPScript pour accéder en lecture à ces types de propriétés d'objets. Vous pouvez, par exemple, demander le nom de l'unité d'un ensemble de données ou la position actuelle du curseur dans un graphique. Pour ce faire, utilisez la syntaxe suivante :
[Object].Property[(Parameter1,..., Parameter n)]
Object est le nom du chemin de l'objet et Property est le nom de la propriété à laquelle vous voulez accéder. Si l'objet n'est pas un objet de données, c'est-à-dire un ensemble de données ou une formule, vous devez ajouter au nom de l'objet l'extension du nom de fichier décrivant le type d'objet. Si vous ne spécifiez pas de nom d'objet, l'accès se fait à la formule contenant le code FPScript. Pour accéder à certains objets, qui dépendent du contexte de la formule FPScript traitée, utilisez les mots-clés This, ThisFPObject ou ThisObject. Dans le cas d'un FPScript embarqué, vous devez utiliser la balise Ce .
Diagram.2D.Name fournit le nom du graphique 2D Diagram sous forme de chaîne de caractères. Lenom dans ce cas est le nom de la propriété à lire et .2D est l'extension de fichier pour le graphique 2D.
.\.FullName fournit le nom du chemin absolu du dossier dans lequel se trouve la formule FPScript.
\.Comments fournit les commentaires du dossier racine de la base de données du projet.
.UnitY renvoie l'unité physique de la composante Y de la formule contenant cette expression FPScript.
Vous pouvez également accéder aux propriétés d'un objet à l'aide d'une variable si vous lui avez déjà attribué une référence d'objet :
Dim Obj = MyDataset As Object
Obj.CommentairesX
L'accès en écriture aux propriétés des objets est fortement réduit et n'est autorisé que pour les informations d'en-tête de la formule contenant le code FPScript. Il est toutefois préférable de traiter les entrées correspondantes dans la boîte de dialogue Propriétés de la formule pour ces propriétés plutôt que de les écrire dans le code FPScript. Lors de chaque processus de mise à jour, les formules qui utilisent ce type d'accès en écriture ne sont pas considérées comme à jour et doivent donc être recalculées à chaque fois. Il est plus logique d'avoir un accès en écriture aux propriétés des objets dans le FPScript intégré.
Au lieu de spécifier directement le nom du chemin de l'objet ou le nom de la propriété, vous pouvez utiliser l'opérateur d'indirection, qui utilise une chaîne contenant le nom. La liste des paramètres n'est requise que pour les propriétés qui nécessitent des paramètres supplémentaires. Pour accéder à la position du curseur dans un graphique au sein d'une feuille de travail, par exemple, vous devez spécifier le numéro du plan et le numéro du curseur.
FPScript permet un accès en lecture à toutes les propriétés des objets définis dans le modèle d'objet d'automatisation FlexPro. Il est très fréquemment utilisé dans les formules FPScript intégrées, qui servent, par exemple, à étiqueter les axes dans un graphique. Dans les formules FPScript que vous utilisez pour l'analyse des données, cet accès vise principalement les attributs et les paramètres des objets ainsi que les curseurs et les marqueurs dans les graphiques. Vous pouvez accéder aux expressions FPScript nécessaires à cet effet par l'intermédiaire de l'assistant de propriétés d'objet de l'éditeur de formules.