|
|
|
hildon 2.1.24 Reference Manual | |
|---|---|---|---|---|
HildonSetPasswordDialogHildonSetPasswordDialog — A dialog used to set, change or remove a password. |
 |
HildonSetPasswordDialog;
GtkWidget* hildon_set_password_dialog_new (GtkWindow *parent,
gboolean modify_protection);
GtkWidget* hildon_set_password_dialog_new_with_default
(GtkWindow *parent,
const gchar *password,
gboolean modify_protection);
const gchar* hildon_set_password_dialog_get_password
(HildonSetPasswordDialog *dialog);
gboolean hildon_set_password_dialog_get_protected
(HildonSetPasswordDialog *dialog);
void hildon_set_password_dialog_set_message
(HildonSetPasswordDialog *dialog,
const gchar *message);
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkBin
+----GtkWindow
+----GtkDialog
+----HildonSetPasswordDialog
"message" gchar* : Read / Write "modify-protection" gboolean : Read / Write / Construct Only "password" gchar* : Read / Write
HildonSetPasswordDialog allows setting and changing a password.
In Change mode: Dialog is used to change or remove an existing password. Unselecting the check box dims the password fields below it. If the dialog is accepted with 'OK' while the check box is unselected, a Confirmation Note is shown. If the Confirmation Note Dialog is accepted with 'Remove', the password protection is removed.
In Set mode: Set Password Dialog is used to define a password, or change a password that cannot be removed.
typedef struct _HildonSetPasswordDialog HildonSetPasswordDialog;
HildonSetPasswordDialog is deprecated and should not be used in newly-written code.
GtkWidget* hildon_set_password_dialog_new (GtkWindow *parent,
gboolean modify_protection);
hildon_set_password_dialog_new is deprecated and should not be used in newly-written code.
Constructs a new HildonSetPasswordDialog.
parent : |
parent window; can be NULL |
modify_protection : |
TRUE creates a new change password dialog and FALSE creates a new set password dialog |
| Returns : | a new GtkWidget of type HildonSetPasswordDialog |
GtkWidget* hildon_set_password_dialog_new_with_default
(GtkWindow *parent,
const gchar *password,
gboolean modify_protection);
hildon_set_password_dialog_new_with_default is deprecated and should not be used in newly-written code.
Same as hildon_set_password_dialog_new, but with a default password in password field.
parent : |
parent window; can be NULL |
password : |
a default password to be shown in password field |
modify_protection : |
TRUE creates a new change password dialog and FALSE creates a new set password dialog |
| Returns : | a new GtkWidget of type HildonSetPasswordDialog |
const gchar* hildon_set_password_dialog_get_password
(HildonSetPasswordDialog *dialog);
hildon_set_password_dialog_get_password is deprecated and should not be used in newly-written code.
Returns current password.
dialog : |
pointer to HildonSetPasswordDialog |
| Returns : | changed password ( if the dialog is successfully accepted with 'OK' ( and when the check box is 'ON' ( in Change Password Dialog )) |
gboolean hildon_set_password_dialog_get_protected
(HildonSetPasswordDialog *dialog);
hildon_set_password_dialog_get_protected is deprecated and should not be used in newly-written code.
Returns the protection mode.
dialog : |
pointer to HildonSetPasswordDialog |
| Returns : | password protection mode ( TRUE when the protection is 'ON' and FALSE when the protection is 'OFF' ) |
void hildon_set_password_dialog_set_message
(HildonSetPasswordDialog *dialog,
const gchar *message);
hildon_set_password_dialog_set_message is deprecated and should not be used in newly-written code.
Sets the optional descriptive text.
dialog : |
the dialog |
message : |
the message or some other descriptive text to be set |