HildonLoginDialog

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

Synopsis


#include <hildon/hildon.h>

                    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 AtkImplementorIface and GtkBuildable.

Properties

  "message"                  gchar*                : Read / Write
  "password"                 gchar*                : Read / Write
  "username"                 gchar*                : 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;

Warning

HildonLoginDialog is deprecated and should not be used in newly-written code.


hildon_login_dialog_new ()

GtkWidget*          hildon_login_dialog_new             (GtkWindow *parent);

Warning

hildon_login_dialog_new is deprecated and should not be used in newly-written code.

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

Warning

hildon_login_dialog_new_with_default is deprecated and should not be used in newly-written code.

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

Warning

hildon_login_dialog_get_username is deprecated and should not be used in newly-written code.

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

Warning

hildon_login_dialog_get_password is deprecated and should not be used in newly-written code.

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

Warning

hildon_login_dialog_set_message is deprecated and should not be used in newly-written code.

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"                  gchar*                : Read / Write

Optional message displayed to the user.

Default value: NULL


The "password" property

  "password"                 gchar*                : Read / Write

Contents of the password field.

Default value: "DEFAULT"


The "username" property

  "username"                 gchar*                : Read / Write

Contents of the username field.

Default value: "DEFAULT"

See Also

HildonGetPasswordDialog, HildonSetPasswordDialog