Top |
GtkWidget * | gdaui_login_new () |
void | gdaui_login_set_mode () |
const GdaDsnInfo * | gdaui_login_get_connection_information () |
void | gdaui_login_set_dsn () |
void | gdaui_login_set_connection_information () |
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.
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. |