| Maeomm Reference Documentation: hildonmm |

Hildon::Entry is a text entry. It is derived from Gtk::Entry and provides additional commodities specific to the Hildon framework.
Besides all the features inherited from Gtk::Entry, a Hildon::Entry can also have a placeholder text. This text will be shown if the entry is empty and doesn't have the input focus, but is otherwise ignored. Thus, calls to Hildon::Entry::get_text() will never return the placeholder text, not even when it's being displayed.
Although Hildon::Entry is derived from Gtk::Entry, Gtk::Entry::get_text() and Gtk::Entry::set_text() must never be used to get/set the text in this widget. Hildon::Entry::get_text() and Hildon::Entry::set_text() must be used instead.
Public Member Functions | |
| Entry (Gtk::Hildon::SizeType size) | |
| Glib::ustring | get_text () const |
| Gets the current text in entry. | |
| const HildonEntry* | gobj () const |
| Provides access to the underlying C GtkObject. | |
| HildonEntry* | gobj () |
| Provides access to the underlying C GtkObject. | |
| void | set_placeholder (const Glib::ustring& text) |
| Sets the placeholder text in entry to text. | |
| void | set_text (const Glib::ustring& text) |
| Sets the text in entry to text, replacing its current contents. | |
| virtual | ~Entry () |
Related Functions | |
| (Note that these are not member functions.) | |
| Hildon::Entry* | wrap (HildonEntry* object, bool take_copy=false) |
| A Glib::wrap() method for this object. | |
| virtual Hildon::Entry::~Entry | ( | ) | [virtual] |
Reimplemented from Gtk::Entry.
| Hildon::Entry::Entry | ( | Gtk::Hildon::SizeType | size | ) | [explicit] |
| Glib::ustring Hildon::Entry::get_text | ( | ) | const |
Gets the current text in entry.
Note that you must never use gtk_entry_get_text() to get the text from a Hildon::Entry.
Also note that placeholder text (set using set_placeholder()) is never returned. Only text set by set_text() or typed by the user is considered.
Reimplemented from Gtk::Entry.
| const HildonEntry* Hildon::Entry::gobj | ( | ) | const [inline] |
| HildonEntry* Hildon::Entry::gobj | ( | ) | [inline] |
| void Hildon::Entry::set_placeholder | ( | const Glib::ustring & | text | ) |
Sets the placeholder text in entry to text.
| text | The new text. |
| void Hildon::Entry::set_text | ( | const Glib::ustring & | text | ) |
Sets the text in entry to text, replacing its current contents.
Note that you must never use gtk_entry_set_text() to set the text of a Hildon::Entry.
| text | The new text. |
Reimplemented from Gtk::Entry.
| Hildon::Entry* wrap | ( | HildonEntry * | object, | |
| bool | take_copy = false | |||
| ) | [related] |
A Glib::wrap() method for this object.
| object | The C instance. | |
| take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |