|  |  |  | GNOME Data Access 5 manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
struct GdauiLogin; GtkWidget * gdaui_login_new (const gchar *dsn); enum GdauiLoginMode; void gdaui_login_set_mode (GdauiLogin *login,GdauiLoginMode mode); const GdaDsnInfo * gdaui_login_get_connection_information (GdauiLogin *login); void gdaui_login_set_dsn (GdauiLogin *login,const gchar *dsn); void gdaui_login_set_connection_information (GdauiLogin *login,const GdaDsnInfo *cinfo);
GObject +----GInitiallyUnowned +----GtkWidget +----GtkContainer +----GtkBox +----GdauiLogin
The GdauiLogin widget can be used when the user needs to enter data to open a connection. It can be customized in several ways:
data source (DSN) selection can be shown or hidden
the button to launch the control center to declare new data sources can be shown or hidden
the form to open a connection not using a DSN can be shown or hidden
GtkWidget *         gdaui_login_new                     (const gchar *dsn);
Creates a new login widget which enables the user to specify connection parameters.
| 
 | a data source name, or NULL. [allow-none] | 
| Returns : | a new widget. [transfer full] | 
Since 4.2
typedef enum {
	GDA_UI_LOGIN_ENABLE_CONTROL_CENTRE_MODE = 1 << 0,
	GDA_UI_LOGIN_HIDE_DSN_SELECTION_MODE = 1 << 1,
	GDA_UI_LOGIN_HIDE_DIRECT_CONNECTION_MODE = 1 << 2
} GdauiLoginMode;
Defines the aspect of the GdauiLogin widget
void gdaui_login_set_mode (GdauiLogin *login,GdauiLoginMode mode);
Set how login operates
| 
 | a GdauiLogin object | 
| 
 | a flag | 
Since 4.2
const GdaDsnInfo *  gdaui_login_get_connection_information
                                                        (GdauiLogin *login);
Get the information specified in login as a pointer to a (read-only) GdaDsnInfo.
If the connection is not specified by a DSN, then the 'name' attribute of the returned
GdaDsnInfo will be NULL, and otherwise it will contain the name of the selected DSN.
| 
 | a GdauiLogin object | 
| Returns : | a pointer to a (read-only) GdaDsnInfo. [transfer none] | 
Since 4.2
void gdaui_login_set_dsn (GdauiLogin *login,const gchar *dsn);
Changes the information displayed in login, to represent dsn.
If login's mode has GDA_UI_LOGIN_HIDE_DSN_SELECTION_MODE, then
the DSN information is extracted and displayed in the direct login area.
If dsn is not a declared data source name, then a warning is shown and the result
is the same as having passed NULL for the dsn argument.
In any case login's mode (set by gdaui_login_set_mode()) is not changed.
| 
 | a GdauiLogin object | 
| 
 | a data source name, or NULL. [allow-none] | 
void gdaui_login_set_connection_information (GdauiLogin *login,const GdaDsnInfo *cinfo);
Changes the information displayed in login, to represent cinfo.
If login's mode has GDA_UI_LOGIN_HIDE_DIRECT_CONNECTION_MODE, then
if cinfo->name is not NULL it is displayed in the DSN selector, otherwise
a warning is shown and the result
is the same as having passed NULL for the cinfo argument.
In any case login's mode (set by gdaui_login_set_mode()) is not changed.
| 
 | a GdauiLogin object | 
| 
 | a pointer to a structure representing the information to display. | 
"changed" signalvoid                user_function                      (GdauiLogin *gdauilogin,
                                                        gboolean    arg1,
                                                        gpointer    user_data)       : Run First