GNOME Data Access 5 manual: GdauiLogin

## GdauiLogin GdauiLogin — Connection opening widget |

## Stability Level

Stable, unless otherwise indicated

## Functions

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 ()

## Properties

gchar * | dsn | Read / Write
GdauiLoginMode | mode | Read / Write
gboolean | valid | Read

## Signals

void | changed | Run First

## Types and Values

struct | GdauiLogin
enum | GdauiLoginMode

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBox
                        ╰── GdauiLogin

## Implemented Interfaces

GdauiLogin implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Description

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

## Functions

### gdaui_login_new ()

    GtkWidget *
    gdaui_login_new (const gchar *dsn);

Creates a new login widget which enables the user to specify connection parameters.

#### Parameters

dsn | a data source name, or `NULL`. | [allow-none]

#### Returns

a new widget.

[transfer full]

Since 4.2

### gdaui_login_set_mode ()

    void
    gdaui_login_set_mode (GdauiLogin *login,
                          GdauiLoginMode mode);

Set how `login` operates

#### Parameters

login | a GdauiLogin object |
mode | a flag |

Since 4.2

### gdaui_login_get_connection_information ()

    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.

#### Parameters

login | a GdauiLogin object |

#### Returns

a pointer to a (read-only) GdaDsnInfo.

[transfer none]

Since 4.2

### gdaui_login_set_dsn ()

    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.

#### Parameters

login | a GdauiLogin object |
dsn | a data source name, or `NULL`. | [allow-none]

### gdaui_login_set_connection_information ()

    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.

#### Parameters

login | a GdauiLogin object |
cinfo | a pointer to a structure representing the information to display. |

## Types and Values

### struct GdauiLogin

    struct GdauiLogin;

### enum GdauiLoginMode

Defines the aspect of the GdauiLogin widget

#### Members

GDA_UI_LOGIN_ENABLE_CONTROL_CENTRE_MODE |  |
GDA_UI_LOGIN_HIDE_DSN_SELECTION_MODE |  |
GDA_UI_LOGIN_HIDE_DIRECT_CONNECTION_MODE |  |

## Property Details

### The `“dsn”` property

      “dsn”                      gchar *

Flags: Read / Write

Default value: NULL

### The `“mode”` property

      “mode”                     GdauiLoginMode

Flags: Read / Write

### The `“valid”` property

      “valid”                    gboolean

Flags: Read

Default value: FALSE

## Signal Details

### The `“changed”` signal

    void
    user_function (GdauiLogin *gdauilogin,
                   gboolean    arg1,
                   gpointer    user_data)

Flags: Run First