HildonNamePasswordDialog

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

Synopsis




#define     HILDON_NAME_PASSWORD_DIALOG_TITLE
#define     HILDON_NAME_PASSWORD_DIALOG_NAME
#define     HILDON_NAME_PASSWORD_DIALOG_PASSWORD
#define     HILDON_NAME_PASSWORD_DIALOG_OK
#define     HILDON_NAME_PASSWORD_DIALOG_CANCEL
GtkWidget*  hildon_name_password_dialog_new (GtkWindow *parent);
GtkWidget*  hildon_name_password_dialog_new_with_default
                                            (GtkWindow *parent,
                                             const gchar *name,
                                             const gchar *pass);
const gchar* hildon_name_password_dialog_get_name
                                            (HildonNamePasswordDialog *dialog);
const gchar* hildon_name_password_dialog_get_password
                                            (HildonNamePasswordDialog *dialog);
void        hildon_name_password_dialog_set_domain
                                            (HildonNamePasswordDialog *dialog,
                                             const gchar *domain);

Description

HildonNamePasswordDialog is used to enter a username and password when accessing a password protected function. The widget performs no input checking and is used only for retrieving a user name and a password.

Example:

void _new_name_password_dialog(GtkDialog *options)
{
   gtk_widget_destroy(GTK_WIDGET(nameDialog));
   nameDialog = HILDON_NAME_PASSWORD_DIALOG(hildon_name_password_dialog_new(grand_parent));
   gtk_dialog_run(GTK_DIALOG(nameDialog));
   gtk_widget_hide(GTK_WIDGET(nameDialog));
}
      
void _testNamePasswordDialog(GtkWidget *parent, gchar **help)
{
   GtkWidget *button;
   GtkWidget *vbox = gtk_vbox_new(FALSE, 0);
   grand_parent = GTK_WINDOW(gtk_widget_get_ancestor(parent,GTK_TYPE_WINDOW));
   normalDialog = gtk_dialog_new_with_buttons(``dialog'',grand_parent,GTK_DIALOG_MODAL, GTK_STOCK_OK, GTK_RESPONSE_OK,NULL);
   nameDialog = HILDON_NAME_PASSWORD_DIALOG(hildon_name_password_dialog_new(grand_parent));
   gtk_container_add(GTK_CONTAINER(parent), vbox);
   button = gtk_button_new_with_label(_(``Name and Password Dialog''));
   gtk_box_pack_start(GTK_BOX(vbox), button, FALSE, FALSE, 0);
   g_signal_connect(G_OBJECT(button), ``clicked'', G_CALLBACK(_new_name_password_dialog), NULL);
   gtk_widget_show_all(vbox);
}

Details

HILDON_NAME_PASSWORD_DIALOG_TITLE

#define HILDON_NAME_PASSWORD_DIALOG_TITLE "frw_ti_get_user_name_and_pwd"

HILDON_NAME_PASSWORD_DIALOG_NAME

#define     HILDON_NAME_PASSWORD_DIALOG_NAME

HILDON_NAME_PASSWORD_DIALOG_PASSWORD

#define     HILDON_NAME_PASSWORD_DIALOG_PASSWORD

HILDON_NAME_PASSWORD_DIALOG_OK

#define HILDON_NAME_PASSWORD_DIALOG_OK "frw_bd_get_user_name_and_pwd_ok"

HILDON_NAME_PASSWORD_DIALOG_CANCEL

#define     HILDON_NAME_PASSWORD_DIALOG_CANCEL

hildon_name_password_dialog_new ()

GtkWidget*  hildon_name_password_dialog_new (GtkWindow *parent);

Creates a new HildonNamePasswordDialog widget with Ok and Close buttons.

`parent` :	the parent window of the dialog
Returns :	the newly created HildonNamePasswordDialog

hildon_name_password_dialog_new_with_default ()

GtkWidget*  hildon_name_password_dialog_new_with_default
                                            (GtkWindow *parent,
                                             const gchar *name,
                                             const gchar *pass);

Same as hildon_name_password_dialog_new, but with a default name and password.

`parent` :	the parent window of the dialog
`name` :	default username, NULL if unset
`pass` :
Returns :	the newly created HildonNamePasswordDialog

hildon_name_password_dialog_get_name ()

const gchar* hildon_name_password_dialog_get_name
                                            (HildonNamePasswordDialog *dialog);

Gets the text that's in the name entry.

`dialog` :	the dialog
Returns :	a pointer to the name string.

hildon_name_password_dialog_get_password ()

const gchar* hildon_name_password_dialog_get_password
                                            (HildonNamePasswordDialog *dialog);

Gets the text that's in the password entry.

`dialog` :	the dialog
Returns :	a pointer to the password string

hildon_name_password_dialog_set_domain ()

void        hildon_name_password_dialog_set_domain
                                            (HildonNamePasswordDialog *dialog,
                                             const gchar *domain);

sets the optional descriptive text

`dialog` :	the dialog
`domain` :	the domain or some other descriptive text to be set