| GNOME Data Access 4 manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
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 +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkVBox +----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
|
Returns : |
a new widget |
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;
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.
Retuns: a pointer to a (read-only) GdaDsnInfo.
|
a GdauiLogin object |
Returns : |
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
|
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
|
the object which received the signal. |
|
|
|
user data set when the signal handler was connected. |