3.2. Overview of the GNOME-DB widgets

This section contains an overview of what can be done with the widgets provided by the GNOME-DB library. It contains short explanations of the basic functionality and use of each widget.

3.2.1. GnomeDbLogin widget

The GnomeDbLogin widget provides a custom way of visually connecting your application to a GDA provider. It can be added to any container widget, so that you can create, for example, a dialog box, and then add the GnomeDbLogin widget to it.

At initialization, it reads the GDA configuration and provides a combo box containing all user-configured data sources. The user just has to select the data source and provide his/her username and password. It also shows a list of the most recently accessed data sources, so that you can quickly connect to your "favorite" databases.

3.2.2. GnomeDbLoginDlg widget

This is a convenience widget which simply contains a GnomeDbLogin widget. It is a subclass of GnomeDialog, so you'll expect it to have a common look&feel with the rest of your application.

This widget does not only contain the GnomeDbLogin widget, but it catches the containee's signals, so if you use it, you should connect to the GnomeDbLoginDlg's signals instead of the GnomeDbLogin ones.

3.2.3. GnomeDbDsnConfig widget

The GnomeDbDsnConfig widget provides a way of letting the user visually manage GDA data sources. This widget can easily be inserted in a configuration dialog box, for example, and thus provides a visual interface to the GDA configuration files.

This widget is a visual wrapper around the GdaDsn management functions.

3.2.4. GnomeDbBrowser widget