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.
Since: 4.2
void gdaui_login_set_mode (GdauiLogin *login,GdauiLoginMode mode);
Set how login
operates
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 or NULL
if no DSN selected or connection specified but "OK" button pressed.
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.
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.
login |
a GdauiLogin object |
|
cinfo |
a pointer to a structure representing the information to display. |
struct GdauiLoginClass {
GtkBoxClass parent_class;
/* signals */
void (*changed) (GdauiLogin *login, gboolean is_valid);
gpointer padding[12];
};
“changed” signalvoid user_function (GdauiLogin *gdauilogin, gboolean arg1, gpointer user_data)
Flags: Run First