Saltar navegación

Documentación de FlexPro 2025

Acceso a las propiedades del objeto

Los objetos almacenados en la base de datos del proyecto, por ejemplo, documentos o diagramas, tienen una serie de propiedades. Por ejemplo, cada objeto tiene un nombre o una fecha de creación, los conjuntos de datos tienen una unidad física, etc. Puede leer estas propiedades de los objetos con FPScript. Por ejemplo, puede consultar el nombre de la unidad de un conjunto de datos o la posición actual del cursor en un diagrama. Para ello, utilice la siguiente sintaxis:

[Objeto].propiedad[(parámetro 1, ..., parámetro n)]

Objeto es el nombre de la ruta del objeto y Propiedad es el nombre de la propiedad a la que desea acceder. Si el objeto no es un objeto de datos, es decir, un conjunto de datos o una fórmula, deberá adjuntar al nombre del objeto la extensión de nombre que especifica el tipo de objeto. Si no se especifica un nombre de objeto, se accede a la fórmula que contiene el código FPScript. Puede acceder a determinados objetos que dependen del contexto en el que se procesa la fórmula FPScript utilizando las palabras clave This, ThisFPObject o ThisObject. Para FPScript incrustado, debe utilizar la palabra clave This.

Diagrama.2D.nombre devuelve el nombre del diagrama 2D Diagrama como cadena. Nombre es el nombre de la propiedad que se va a leer y .2D es la extensión de nombre para diagramas 2D.

.\.FullName devuelve el nombre de ruta absoluto de la carpeta en la que se encuentra la fórmula FPScript.

\. Comments devuelve el comentario de la carpeta raíz de la base de datos del proyecto.

.UnitY devuelve la unidad física del componente Y de la fórmula en la que se encuentra la instrucción FPSccript.

También puede acceder a las propiedades de un objeto a través de una variable si previamente le ha asignado una referencia de objeto:

Dim Obj = MyDataset As Object

Obj.CommentsX

El acceso de escritura a las propiedades de los objetos está muy restringido y solo se permite para la información de cabecera de la fórmula en la que se encuentra el código FPScript. También es preferible hacer las entradas correspondientes para estas propiedades en el cuadro de diálogo de propiedades de la fórmula, en lugar de escribirlas en el código FPScript. Las fórmulas que utilizan estos accesos de escritura ya no se consideran actualizadas cada vez que se actualizan y, por lo tanto, se vuelven a calcular cada vez. El acceso de escritura a las propiedades de los objetos en FPScript incrustado tiene sentido.

En lugar de especificar el nombre de la ruta del objeto o el nombre de la propiedad directamente, puede utilizar el operador de indirección, que lo extrae de una cadena. La lista de parámetros solo es necesaria para las propiedades que requieren una parametrización adicional. Por ejemplo, para acceder a la posición del cursor de un diagrama en una planilla, debe especificar el número del nivel y el número del cursor.

FPScript permite el acceso de lectura a todas las propiedades de objetos que están definidas en el modelo de objetos de automatización de FlexPro. Se utiliza de forma intensiva, sobre todo en las fórmulas FPScript incrustadas, que se emplean, por ejemplo, para etiquetar los ejes de un diagrama. Dentro de las fórmulas FPScript que se utilizan para analizar datos, el acceso se limita esencialmente a los atributos y parámetros de los objetos, así como a los cursores y marcadores de los diagramas. Las expresiones FPScript necesarias para ello las proporciona el asistente para propiedades de objetos del editor de fórmulas.

Véase también

Lista de todas las propiedades que se pueden seleccionar en el asistente