HdyDialer

HdyDialer — A keypad for dialing numbers

Functions

GtkWidget * hdy_dialer_new ()
const gchar * hdy_dialer_get_number ()
void hdy_dialer_set_number ()
void hdy_dialer_clear_number ()
gboolean hdy_dialer_get_show_action_buttons ()
void hdy_dialer_set_show_action_buttons ()

Properties

guint column-spacing Read / Write
char * number Read / Write
guint row-spacing Read / Write
gboolean show-action-buttons Read / Write

Signals

void deleted Run Last
void submitted Run Last
void symbol-clicked Run Last

Types and Values

#define HDY_TYPE_DIALER
struct HdyDialerClass
  HdyDialer

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkEventBox
                        ╰── HdyDialer

Implemented Interfaces

HdyDialer implements AtkImplementorIface and GtkBuildable.

Description

The HdyDialer widget is a keypad for entering numbers such as phone numbers or PIN codes.

Functions

hdy_dialer_new ()

GtkWidget *
hdy_dialer_new (void);

Create a new HdyDialer widget.

Returns

the newly created HdyDialer widget

hdy_dialer_get_number ()

const gchar *
hdy_dialer_get_number (HdyDialer *self);

Get the currently displayed number.

Parameters

self

a HdyDialer

  

Returns

the current number in the display.

[transfer none]

hdy_dialer_set_number ()

void
hdy_dialer_set_number (HdyDialer *self,
                       const char *number);

Set the currently displayed number.

Parameters

self

a HdyDialer

  

number

the number to set.

[transfer none]

hdy_dialer_clear_number ()

void
hdy_dialer_clear_number (HdyDialer *self);

Set the current number to the empty string. When the number is already cleared no action is performed.

Parameters

self

a HdyDialer

  

hdy_dialer_get_show_action_buttons ()

gboolean
hdy_dialer_get_show_action_buttons (HdyDialer *self);

Get whether the submit and delete buttons are to be shown.

Parameters

self

a HdyDialer

  

Returns

whether the buttons are to be shown

hdy_dialer_set_show_action_buttons ()

void
hdy_dialer_set_show_action_buttons (HdyDialer *self,
                                    gboolean show);

Set whether to show the submit and delete buttons.

Parameters

self

a HdyDialer

  

show

whether to show the buttons

  

Types and Values

HDY_TYPE_DIALER

#define HDY_TYPE_DIALER (hdy_dialer_get_type())

struct HdyDialerClass

struct HdyDialerClass {
  GtkEventBoxClass parent_class;

  /* Signals
   */
  void (*submitted)   (HdyDialer    *self,
                       const gchar  *number);
};

Members

submitted ()

Class handler for the “submitted” signal

  

HdyDialer

typedef struct _HdyDialer HdyDialer;

Property Details

The “column-spacing” property

  “column-spacing”           guint

The amount of space between two consecutive columns.

Owner: HdyDialer

Flags: Read / Write

Default value: 0

The “number” property

  “number”                   char *

The phone number to dial.

Owner: HdyDialer

Flags: Read / Write

Default value: ""

The “row-spacing” property

  “row-spacing”              guint

The amount of space between two consecutive rows.

Owner: HdyDialer

Flags: Read / Write

Default value: 0

The “show-action-buttons” property

  “show-action-buttons”      gboolean

Whether to show the submit and delete buttons.

Owner: HdyDialer

Flags: Read / Write

Default value: TRUE

Signal Details

The “deleted” signal

void
user_function (HdyDialer *self,
               gpointer   user_data)

This signal is emitted when the dialer's 'deleted' button is clicked to delete the last symbol.

Parameters

self

The HdyDialer instance.

  

user_data

user data set when the signal handler was connected.

  

Flags: Run Last

The “submitted” signal

void
user_function (HdyDialer *self,
               char      *number,
               gpointer   user_data)

This signal is emitted when the dialer's 'dial' button is activated. Connect to this signal to perform to get notified when the user wants to submit the dialed number.

Parameters

self

The HdyDialer instance.

  

number

The number at the time of activation.

  

user_data

user data set when the signal handler was connected.

  

Flags: Run Last

The “symbol-clicked” signal

void
user_function (HdyDialer *self,
               char       button,
               gpointer   user_data)

This signal is emitted when one of the symbol buttons (0-9, # or *) is clicked. Connect to this signal to find out which button was pressed. This doesn't take any cycling modes into account. So the button with "*" and "+" on it will always send "*". Delete and Submit buttons will not trigger this signal.

Parameters

self

The HdyDialer instance.

  

button

The main symbol on the button that was clicked

  

user_data

user data set when the signal handler was connected.

  

Flags: Run Last

Generated by GTK-Doc V1.33.0