## GnomeDbLogin

GnomeDbLogin — Login widget

##

# Synopsis

    struct      GnomeDbLogin;
    struct      GnomeDbLoginClass;
    struct      GnomeDbLoginPrivate;
    GtkWidget*  gnome_db_login_new              (const gchar *dsn);
    const gchar* gnome_db_login_get_dsn         (GnomeDbLogin *login);
    void        gnome_db_login_set_dsn          (GnomeDbLogin *login,
                                                 const gchar *dsn);
    const gchar* gnome_db_login_get_auth        (GnomeDbLogin *login);
    void        gnome_db_login_set_auth         (GnomeDbLogin *login,
                                                 const gchar *auth);
    const gchar* gnome_db_login_get_username    (GnomeDbLogin *login);
    void        gnome_db_login_set_username     (GnomeDbLogin *login,
                                                 const gchar *username);
    const gchar* gnome_db_login_get_password    (GnomeDbLogin *login);
    void        gnome_db_login_set_password     (GnomeDbLogin *login,
                                                 const gchar *password);
    void        gnome_db_login_set_enable_create_button
                                                (GnomeDbLogin *login,
                                                 gboolean enable);
    gboolean    gnome_db_login_get_enable_create_button
                                                (GnomeDbLogin *login);
    void        gnome_db_login_set_show_dsn_selector
                                                (GnomeDbLogin *login,
                                                 gboolean show);
    gboolean    gnome_db_login_get_show_dsn_selector
                                                (GnomeDbLogin *login);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkVBox
                                           +----GnomeDbLogin

## Implemented Interfaces

GnomeDbLogin implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Properties

      "dsn"                  gchararray           : Read
      "hiding-button"        gboolean             : Read / Write
      "hiding-dsn"           gboolean             : Read / Write
      "password"             gchararray           : Read
      "username"             gchararray           : Read

## Signal Prototypes

    "dsn-changed"
                void        user_function      (GnomeDbLogin *dblogin,
                                                gpointer user_data);

## Description

## Details

### struct GnomeDbLogin

    struct GnomeDbLogin;

### struct GnomeDbLoginClass

    struct GnomeDbLoginClass {

    	GtkVBoxClass         parent_class;

    	/* signals */
    	void               (*dsn_changed) (GnomeDbLogin *login);
    };

### struct GnomeDbLoginPrivate

    struct GnomeDbLoginPrivate;

### gnome_db_login_new ()

    GtkWidget*  gnome_db_login_new              (const gchar *dsn);

`dsn` : |
Returns : |

### gnome_db_login_get_dsn ()

    const gchar* gnome_db_login_get_dsn         (GnomeDbLogin *login);

`login` : |
Returns : |

### gnome_db_login_set_dsn ()

    void        gnome_db_login_set_dsn          (GnomeDbLogin *login,
                                                 const gchar *dsn);

Set the data source name on the given GnomeDbLogin widget.

`login` : | A GnomeDbLogin widget.
`dsn` : | Data source name.

### gnome_db_login_get_auth ()

    const gchar* gnome_db_login_get_auth        (GnomeDbLogin *login);

`login` : | a GnomeDbLogin widget
Returns : | the authentication string

### gnome_db_login_set_auth ()

    void        gnome_db_login_set_auth         (GnomeDbLogin *login,
                                                 const gchar *auth);

Update the authentication part of `login` using `auth`

`login` : | a GnomeDbLogin widget
`auth` : | an authentication string, or `NULL`

### gnome_db_login_get_username ()

    const gchar* gnome_db_login_get_username    (GnomeDbLogin *login);

Get the value currently entered in the username text entry.

`login` : | A GnomeDbLogin widget.
Returns : | the username being entered in the login widget.

### gnome_db_login_set_username ()

    void        gnome_db_login_set_username     (GnomeDbLogin *login,
                                                 const gchar *username);

Sets the user name to be displayed in the given GnomeDbLogin widget.

`login` : | a GnomeDbLogin widget.
`username` : | username to display in the widget.

### gnome_db_login_get_password ()

    const gchar* gnome_db_login_get_password    (GnomeDbLogin *login);

`login` : |
Returns : |

### gnome_db_login_set_password ()

    void        gnome_db_login_set_password     (GnomeDbLogin *login,
                                                 const gchar *password);

Sets the password to be displayed in the given GnomeDbLogin widget.

`login` : | a GnomeDbLogin widget.
`password` : | password to display in the widget.

### gnome_db_login_set_enable_create_button ()

    void        gnome_db_login_set_enable_create_button
                                                (GnomeDbLogin *login,
                                                 gboolean enable);

Enable/disable the button allowing the user to create new data sources from the login widget. This button is disabled by default, and when enabled, allows the user to start the database properties configuration applet.

`login` : | A GnomeDbLogin widget.
`enable` : | Flag to enable/disable the button.

### gnome_db_login_get_enable_create_button ()

    gboolean    gnome_db_login_get_enable_create_button
                                                (GnomeDbLogin *login);

Tell if the the button allowing the user to create new data sources is shown or not. This button is disabled by default,

`login` : | A GnomeDbLogin widget.
Returns : | TRUE if the button is shown

### gnome_db_login_set_show_dsn_selector ()

    void        gnome_db_login_set_show_dsn_selector
                                                (GnomeDbLogin *login,
                                                 gboolean show);

Show/hide the combo box which allows to select the datasource to log into.

`login` : | A GnomeDbLogin widget.
`show` : |

### gnome_db_login_get_show_dsn_selector ()

    gboolean    gnome_db_login_get_show_dsn_selector
                                                (GnomeDbLogin *login);

Tells if the combo box which allows to select the datasource to log into is shown or not.

`login` : | A GnomeDbLogin widget.
Returns : | TRUE if the combo box is shown

## Properties

"`dsn`" (gchararray : Read) |
"`hiding-button`" (gboolean : Read / Write) |
"`hiding-dsn`" (gboolean : Read / Write) |
"`password`" (gchararray : Read) |
"`username`" (gchararray : Read) |

## Signals

### The "dsn-changed" signal

    void        user_function                  (GnomeDbLogin *dblogin,
                                                gpointer user_data);

`dblogin` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.