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;


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.