Maeomm Reference Documentation: hildon-libsmm |
There are two modes to choose from: coerce or free format.
Coerce format has three fields which are placed horizontally. The fields are: country code, area code and number. When nothing is entered in the fields, assisting text is displayed. Tapping on the field highlights the field and allows users to input numbers.
The widget is used where a user should enter a phone number. Free format should be used wherever possible as it enables the user to enter the phone number in whatever format he likes. Free format also supports DTMF strings as a part of the phone number. The format cannot be changed at runtime.
Public Member Functions | |
Glib::ustring | get_area () const |
Get text in the area field in coarse format. | |
Glib::ustring | get_country () const |
Get text in the country field in coarse format. | |
Glib::ustring | get_number () const |
Get text in the number field in all formats. | |
bool | get_show_border () const |
Get the visibility status of the border around the widget. | |
bool | get_show_plus () const |
Get the visibility status of the plus sign in front of coerce format's country field. | |
const HildonTelephoneEditor* | gobj () const |
Provides access to the underlying C GtkObject. | |
HildonTelephoneEditor* | gobj () |
Provides access to the underlying C GtkObject. | |
void | set_area (const Glib::ustring& area) |
Set text in the area field in coarse format. | |
void | set_country (const Glib::ustring& country) |
Set text in the country field in coarse format. | |
void | set_editable (bool country=true, bool area=true, bool number=true) |
Specify wheter the fields in coerse format are editable or not. | |
void | set_number (const Glib::ustring& number) |
Set text in the number field in all formats. | |
void | set_show_border (bool show=true) |
Show or hide the border around the widget. | |
void | set_show_plus (bool show=true) |
Show or hide the plus sign in front of coerce format's country field. | |
void | set_widths (guint country, guint area, guint number) |
Set widths of the fields in coecse format. | |
TelephoneEditor (TelephoneEditorFormat format, const Glib::ustring& country, const Glib::ustring& area, const Glib::ustring& number) | |
TelephoneEditor (TelephoneEditorFormat format) | |
virtual | ~TelephoneEditor () |
Related Functions | |
(Note that these are not member functions.) | |
Hildon::TelephoneEditor* | wrap (HildonTelephoneEditor* object, bool take_copy=false) |
|
|
|
|
|
|
|
Get text in the area field in coarse format. This function must not be called if in free mode or in HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_COUNTRY mode.
|
|
Get text in the country field in coarse format. This function must not be called if in free mode.
|
|
Get text in the number field in all formats. In free mode, this functions returns the whole phone number. In coarce mode, it returns only the number field. This function must not be called if the editor is in HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_AREA or HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_COUNTRY modes.
|
|
Get the visibility status of the border around the widget.
|
|
Get the visibility status of the plus sign in front of coerce format's country field.
|
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Container. |
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Container. |
|
Set text in the area field in coarse format. This function must not be called if in free mode or in HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_COUNTRY mode.
|
|
Set text in the country field in coarse format. This function must not be called if in free mode.
|
|
Specify wheter the fields in coerse format are editable or not. This function is ignored if the editor is in free mode. The number or area and number parameters are ignored if the editor is in HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_AREA or HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_COUNTRY formats, respectively.
|
|
Set text in the number field in all formats. In free mode this functions sets the whole phone number. In coerce mode, it sets only the number field. This function must not be called if the editor is in HILDON_TELEPHONE_EDITOR_FORMAT_COERSE_AREA or HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_COUNTRY modes.
|
|
Show or hide the border around the widget.
|
|
Show or hide the plus sign in front of coerce format's country field.
|
|
Set widths of the fields in coecse format. Country and area parameters are ignored, if the editor is in free mode. The number or area and number parameters are ignored if the editor is in HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_AREA or HILDON_TELEPHONE_EDITOR_FORMAT_COERCE_COUNTRY mode, respectively.
|
|
|