Esta sección contiene una Vista previa sobre qué puede hacer con los widgets que provee la biblioteca GNOME-DB. Contiene también una breve explicación de su funcionalidad básica y cómo usar cada widget.
El widget GnomeDbLogin provee una manera personalizable de conectar visualmente su aplicación a con un proveedor GDA. Se puede añadir a cualquier contenedor de widgets, para crear, por ejemplo, una cuadro de diálogo, y después añadir el widget GnomeDbLogin dentro de él.
En su inicialización, lee la configuración de GDA y provee un cuadro que contiene todas las fuentes de datos configuradas para los usuarios. El ususario sólo tiene que seleccionar la fuente de datos y dar su nombre de usuario y contraseña. También muestra una lista de las fuentes de datos usadas más recientemente para que pueda rápidamente conectar con su bases de datos "favoritas".
Este es el widget adecuado que sólo contiene un widget GnomeDbLogin. Es una subclase de GnomeDialog, así que se espera que tenga el mismo aspecto que el resto de su aplicación.
Este widget no sólo contiene el widget GnomeDbLogin , ya que captura las señales del contenedor, para que, sí lo usa, debiera conectarlo tanto a las señales de GnomeDbLoginDlg como a las de GnomeDbLogin.
El widget GnomeDbDsnConfig provee una manera de permitir visualmente al usuario manejar fuentes de datos GDA. Este widget puede ser insertado fácilmente en un cuadro de diálogo de configuración, por ejemplo, y proveer un interfaz visual de configuración de los ficheros de configuración de GDA.
Este widget es un visual wrapper sobre las funciones de manejo de GdaDsn.
Este es un widget verdaderamente completo que permite explorar la base de datos entera: tablas, vistas, usuarios y los procedimientos almacenados, etc. El caso más sencillo es crear un contenedor y añadirle el widget GnomeDbBrowser . Sólo con esto le da un explorador completo de bases de datos a su aplicación.
Este es el widget más usado en la biblioteca. Provee una manera de inspeccionar visualmente los contenidos de un GdaRecordset. La responsabilidad de la parte de acceso a bases de datos recae enteramente sobre este widget. Soló tiene que pasarle los registros válidos a mostrar.
Los datos son cargados asíncronamente, así que el programa no se bloqueará para que el usuario pueda acceder a otras partes de la aplicación. Una vez que la última fila se ha cargado, el widget GnomeDbGrid emite su señal "loaded"(cargado).
El widget GnomeDbDataset le permite navegar visualmente por los registros devueltos desde la base de datos de uno en uno.
Este widget es realmente muy util. Es usado en las pantallas de introducción de datos, dando una manera en la que el usuario pueda seleccionar un valor entre una lista de valores para un campo dado.
Trabaja básicamente como el widgetGnomeDbGrid, se basa en el GdaRecordset que se le pase, pero en este caso, puede especificar que número de columnas del registro se van a mostrar.
El widget GnomeDbList le permite mostrar una lista de valores para un campo en concreto dentro de un registro. Y también le permite decorar dicha lista con iconos, que dará como resultado un widget resultón para ser incluido en sus pantallas de acceso a bases de datos.
El widget GnomeDbReport provee una manera de presentarle al usuario informes personalizables basados en datos provenientes de una GdaConnection. Para esto usa el motor de informes de la libgda.
La estructura del informe es almacenada en el formato XML, que hace posible la compartición de datos con otras aplicaciones no relacionadas. Este widget sólo lee el fichero XML, obtiene los datos especificados de una base de datos dada y se los presenta al ususario en el formato de instrucciones especificado por la esctrucura del informe.
El widget GnomeDbIconList trabaja como los widgets GnomeDbList y GnomeDbCombo . Pero, en este caso, los valores presentados en un campo dado se representan como iconos. Esto le ofrece - al desarrollador - otra manera de presentar datos al usuarios en su aplicación.
El widget GnomeDbError provee una manera de explorar a través de todos los errores ocurridos en un objeto GdaConnection dado. Usted puede usarlo para informar al usuario cada vez que ocurra algún error o como un widget de informativo.
Tal como pasaba con el widget GnomeDbLoginDlg, el widget GnomeDbErrorDlg sólo es una subclase de GnomeDialog que tal sólo contiene un widget GnomeDbError.