| 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
+----GtkVBox
+----GdauiLogin
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. [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;
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: (transfer none): a pointer to a (read-only) GdaDsnInfo.
|
a GdauiLogin object |
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. |