HildonCodeDialog

HildonCodeDialog — A keypad-like widget used to enter pincodes.

Synopsis

                    HildonCodeDialog;
GtkWidget*          hildon_code_dialog_new              (void);
const gchar*        hildon_code_dialog_get_code         (HildonCodeDialog *dialog);
void                hildon_code_dialog_clear_code       (HildonCodeDialog *dialog);
void                hildon_code_dialog_set_help_text    (HildonCodeDialog *dialog,
                                                         const gchar *text);
void                hildon_code_dialog_set_input_sensitive
                                                        (HildonCodeDialog *dialog,
                                                         gboolean sensitive);

Object Hierarchy

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

Implemented Interfaces

HildonCodeDialog implements AtkImplementorIface and GtkBuildable.

Signals

  "input"                                          : Run Last

Description

HildonCodeDialog displays a keypad that can be used to enter numerical pin codes or lock codes. It emits a 'input' signal each time an input action is performed on the dialog.

Details

HildonCodeDialog

typedef struct _HildonCodeDialog HildonCodeDialog;

Warning

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


hildon_code_dialog_new ()

GtkWidget*          hildon_code_dialog_new              (void);

Warning

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

Use this function to create a new HildonCodeDialog.

Returns : A HildonCodeDialog.

hildon_code_dialog_get_code ()

const gchar*        hildon_code_dialog_get_code         (HildonCodeDialog *dialog);

Warning

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

Use this function to access the code entered by the user.

dialog : The HildonCodeDialog from which to get the entered code
Returns : The entered code.

hildon_code_dialog_clear_code ()

void                hildon_code_dialog_clear_code       (HildonCodeDialog *dialog);

Warning

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

Use this function to clear the user entered code.

dialog : The HildonCodeDialog whose entry should be cleared:

hildon_code_dialog_set_help_text ()

void                hildon_code_dialog_set_help_text    (HildonCodeDialog *dialog,
                                                         const gchar *text);

Warning

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

Use this function to set the text that will be displayd in the help label

dialog : The HildonCodeDialog whose entry should be cleared:
text : The text to use in the help label.

hildon_code_dialog_set_input_sensitive ()

void                hildon_code_dialog_set_input_sensitive
                                                        (HildonCodeDialog *dialog,
                                                         gboolean sensitive);

Warning

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

This function will block or enable the input on the code dialog by making the input button sensitive (or not).

dialog : The HildonCodeDialog whose state is to be changed
sensitive : The new state

Signal Details

The "input" signal

void                user_function                      (HildonCodeDialog *hildoncodedialog,
                                                        gpointer          user_data)             : Run Last

hildoncodedialog : the object which received the signal.
user_data : user data set when the signal handler was connected.