HildonLoginDialog

HildonLoginDialog — A widget which allows a user to enter an username and a password.

Synopsis




            HildonLoginDialog;
GtkWidget*  hildon_login_dialog_new         (GtkWindow *parent);
GtkWidget*  hildon_login_dialog_new_with_default
                                            (GtkWindow *parent,
                                             const gchar *name,
                                             const gchar *password);
const gchar* hildon_login_dialog_get_username
                                            (HildonLoginDialog *dialog);
const gchar* hildon_login_dialog_get_password
                                            (HildonLoginDialog *dialog);
void        hildon_login_dialog_set_message (HildonLoginDialog *dialog,
                                             const gchar *msg);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----HildonLoginDialog

Implemented Interfaces

HildonLoginDialog implements GtkBuildable and AtkImplementorIface.

Properties


  "message"              gchararray            : Read / Write
  "password"             gchararray            : Read / Write
  "username"             gchararray            : Read / Write

Description

HildonLoginDialog is used to enter a username and password when accessing a password protected area. The widget performs no input checking and is used only for retrieving the username and a password.

Details

HildonLoginDialog

typedef struct _HildonLoginDialog HildonLoginDialog;

hildon_login_dialog_new ()

GtkWidget*  hildon_login_dialog_new         (GtkWindow *parent);

Creates a new HildonLoginDialog widget with Ok and Close buttons.

parent : the parent window of the dialog
Returns : the newly created HildonLoginDialog

hildon_login_dialog_new_with_default ()

GtkWidget*  hildon_login_dialog_new_with_default
                                            (GtkWindow *parent,
                                             const gchar *name,
                                             const gchar *password);

Same as hildon_login_dialog_new but with a default username and password.

parent : the parent window of the dialog
name : default username, NULL if unset
password : default password, NULL if unset
Returns : the newly created HildonLoginDialog

hildon_login_dialog_get_username ()

const gchar* hildon_login_dialog_get_username
                                            (HildonLoginDialog *dialog);

Gets the text that's in the username entry.

dialog : the dialog
Returns : a pointer to the name string. You should not modify it.

hildon_login_dialog_get_password ()

const gchar* hildon_login_dialog_get_password
                                            (HildonLoginDialog *dialog);

Gets the text that's in the password entry.

dialog : the dialog
Returns : a pointer to the password string. You should not modify it.

hildon_login_dialog_set_message ()

void        hildon_login_dialog_set_message (HildonLoginDialog *dialog,
                                             const gchar *msg);

Sets the optional descriptive text that is displayed on the top of the dialog.

dialog : the dialog
msg : the message or some other descriptive text to be set

Property Details

The "message" property

  "message"              gchararray            : Read / Write

Optional message displayed to the user.

Default value: NULL

The "password" property

  "password"             gchararray            : Read / Write

Contents of the password field.

Default value: "DEFAULT"

The "username" property

  "username"             gchararray            : Read / Write

Contents of the username field.

Default value: "DEFAULT"

See Also

HildonGetPasswordDialog, HildonSetPasswordDialog