Los objetos son los bloques de construcción fundamentales de Visual Basic; casi todo lo que se hace en Visual Basic implica modificar objetos. Cada elemento de FlexPro (bases de datos, diagramas, tablas, documentos, conjuntos de datos, etc.) puede ser representado por un objeto en Visual Basic.
¿Qué son los objetos y las collecciones?
Un objeto representa un elemento de FlexPro, por ejemplo, una base de datos, un diagrama o una curva individual en un diagrama. Una colección es un objeto que contiene varios objetos, normalmente del mismo tipo; por ejemplo, todas las curvas de un diagrama están contenidas en un único objeto de colección. Puede utilizar propiedades y métodos para modificar un único objeto o una colección completa de objetos.
¿Qué es una propiedad?
Una propiedad es un atributo de un objeto o un aspecto de su comportamiento. Por ejemplo, las propiedades de un diagrama incluyen su nombre, la apariencia de la cuadrícula divisoria y también si los cursores están activados. Para modificar las características de un objeto, cambie los valores de sus propiedades.
Para establecer el valor de una propiedad, escriba un punto, el nombre de la propiedad, un signo igual y el nuevo valor de la propiedad después de la referencia a un objeto. En el siguiente ejemplo, se asigna un nuevo comentario a la carpeta raíz de la base de datos MyDatabase.
Databases("MyDatabase.fpd").RootFolder.Comments = "My Database"
En este ejemplo, Databases se refiere a la colección de bases de datos abiertas. El nombre MyDatabase.fpd identifica una única base de datos en la colección. La propiedad Comments se establece específicamente para la carpeta raíz de esta base de datos.
Algunas propiedades no se pueden configurar. El tema de ayuda de una propiedad indica si esa propiedad puede configurarse (acceso de lectura y escritura) o ser de solo lectura (acceso de solo lectura).
Puede obtener información sobre un objeto devolviendo el valor de una de sus propiedades. En el siguiente ejemplo, se devuelve el nombre de la base de datos activa.
databaseName = ActiveDatabase.Name
En este ejemplo, ActiveDatabase se refiere a la base de datos en la ventana activa en FlexPro. El nombre de esta base de datos se asigna a la variable databaseName.
Nota El tema de ayuda de una propiedad indica si esa propiedad puede configurarse (acceso de lectura y escritura) o ser de solo lectura (acceso de solo lectura). El catálogo de objetos del editor de Visual Basic también muestra el estado de lectura/escritura en la parte inferior de la ventana del catálogo cuando se selecciona la propiedad.
¿Qué es un método?
Un método es una acción que puede realizar un objeto. Dado que un documento FlexPro se puede imprimir, el objeto Document también tiene un método PrintOut, por ejemplo. Los métodos suelen tener argumentos que especifican cómo se realiza la acción. En el siguiente ejemplo, se imprimen las tres primeras páginas del documento activo.
ActiveDatabase.ActiveObject.PrintOut FirstPage:=1, LastPage:=3
En la mayoría de los casos, los métodos son acciones y las propiedades son características. El uso de un método hace que le ocurra algo a un objeto, mientras que el uso de una propiedad devuelve información sobre el objeto o cambia una característica del mismo.
Devolución de un objeto
La mayoría de los objetos se devuelven devolviendo un único objeto de una colección. La colección Databases contiene, por ejemplo, las bases de datos de FlexPro abiertas. Usted utiliza la propiedad Databases del objeto Application (el objeto superior en la jerarquía de objetos FlexPro) para devolver la colección Databases.
Una vez que haya accedido a la colección, puede devolver un único objeto especificando un valor de índice entre paréntesis (de forma similar al trabajo con campos). El valor de índice suele ser un número o un nombre.
En el siguiente ejemplo, la propiedad Databases se utiliza para acceder a la colección Databases. El número de índice se utiliza para devolver la primera base de datos de la colección Databases. A continuación, se aplica el método Close al objeto Database para cerrar la primera base de datos de la colección Databases.
Databases(1).Close
En el siguiente ejemplo, se utiliza un nombre (especificado como cadena) para identificar un objeto Databasesdentro de la colección Databases.
Databases("Report.fpd").Close
Los objetos de lista suelen tener métodos y propiedades que se pueden utilizar para modificar toda la colección de objetos. El objeto Databases tiene un método Save que guarda todos los documentos de la colección. En el siguiente ejemplo, los documentos abiertos se guardan utilizando el método Save.
Databases.Save
El objeto Database también dispone de un método Save para guardar una única base de datos. En el siguiente ejemplo, se guarda la base de datos Report.fpd.
Databases("Report.fpd").Save
Si desea devolver un objeto que se encuentra más abajo en el modelo de objetos FlexPro, debe "profundizar" hasta ese objeto utilizando propiedades y métodos para devolver objetos.
Para ver cómo funciona, abra el editor de Visual Basic y haga clic en Catálogo de objetos en el menú Vista. Haga clic en Application en la lista Clases de la izquierda. A continuación, haga clic en ActiveDatabase en la lista de elementos de la derecha. El texto en la parte inferior del catálogo de objetos indica que ActiveDatabase es una propiedad de solo lectura que devuelve un objeto Database. Haga clic en Database en la parte inferior del catálogo de objetos; el objeto Database se resalta automáticamente en la lista Clases y la lista Elementos muestra los elementos del objeto Database. Desplácese por la lista de elementos hasta encontrar Close. Haga clic en el método Close. El texto de la parte inferior de la ventana Catálogo de objetos muestra la sintaxis del método. Para obtener más información sobre el método, pulse F1 o haga clic en el botón Ayuda y vaya al tema de ayuda Método Close.
Con esta información, puede escribir la siguiente instrucción para cerrar la base de datos activa.
ActiveDatabase.Close SaveChanges:=fpSaveChanges
En el siguiente ejemplo, se cambia el título de la ventana activa.
ActiveDatabase.ActiveWindow.Caption = "My Window"
La propiedad ActiveWindow devuelve un objeto Window que representa la ventana activa. La propiedad Caption se utiliza para establecer el título de la ventana.
El siguiente ejemplo crea una nueva base de datos y muestra el cuadro de diálogo Guardar como para que se pueda asignar un nombre a la base de datos.
Databases.Add.Save
La propiedad Databases devuelve la colección Databases. El método Add crea una nueva base de datos y devuelve un objeto Database. A continuación, el método Save se aplica al objeto Database.
Como puede ver, se utilizan métodos o propiedades para "profundizar" hasta llegar a un objeto. Esto significa que usted devuelve un objeto aplicando un método a un objeto situado por encima de él en la jerarquía de objetos o accediendo a una propiedad. Una vez que haya devuelto el objeto deseado, puede utilizar los métodos de este objeto y controlar sus propiedades. Encontrará un resumen de la jerarquía de objetos en Modelo de objetos FlexPro.
Cómo obtener ayuda sobre objetos, métodos y propiedades
Hasta que esté familiarizado con el modelo de objetos FlexPro, puede utilizar algunas herramientas que le ayudarán a desglosar la jerarquía.
•Listar elementos automáticamente. Si introduce un punto (.) después de un objeto en el editor de Visual Basic, aparecerá una lista de las propiedades y métodos disponibles. Por ejemplo, si introduce Application., aparecerá una lista desplegable con los métodos y propiedades del objeto Application.
•Ayuda. También puede utilizar la función de ayuda para averiguar qué propiedades y métodos pueden utilizarse para un objeto. Cada tema objeto de la ayuda contiene un salto de propiedades y métodos que muestra una lista de las propiedades y métodos del objeto. Pulse F1 en el catálogo de objetos o en un módulo para ir al tema de ayuda correspondiente.
•Modelo de objetos FlexPro. Este tema ilustra como los objetos FlexPro están organizados en la jerarquía. Haga clic en un objeto del gráfico para visualizar el tema de ayuda correspondiente.
•Catálogo de objetos. El catálogo de objetos en el editor de Visual Basic muestra los elementos (propiedades y métodos) de los objetos FlexPro.