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

Signals


"input"     void        user_function      (HildonCodeDialog *hildoncodedialog,
                                            gpointer          user_data)             : 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;

hildon_code_dialog_new ()

GtkWidget*  hildon_code_dialog_new          (void);

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

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

dialog :

hildon_code_dialog_set_help_text ()

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

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

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.