|
|
|
Hildon Reference Manual | |
|---|---|---|---|---|
HildonEntry;
GtkWidget* hildon_entry_new (HildonSizeType size);
void hildon_entry_set_text (HildonEntry *entry,
const gchar *text);
const gchar* hildon_entry_get_text (HildonEntry *entry);
void hildon_entry_set_placeholder (HildonEntry *entry,
const gchar *text);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkEntry +----HildonEntry
HildonEntry implements AtkImplementorIface, GtkBuildable, GtkEditable and GtkCellEditable.
The HildonEntry is text entry derived from the GtkEntry widget providing additional commodities specific to the Hildon framework.
Besides all the features inherited from GtkEntry, a HildonEntry
can also have a placeholder text. This text will be shown if the
entry is empty and doesn't have the input focus, but it's otherwise
ignored. Thus, calls to hildon_entry_get_text() will never return
the placeholder text, not even when it's being displayed.
Although HildonEntry is derived from GtkEntry,
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.
Example 12. Creating a HildonEntry with a placeholder
GtkWidget *
create_entry (void)
{
GtkWidget *entry;
entry = hildon_entry_new (HILDON_SIZE_AUTO);
hildon_entry_set_placeholder (HILDON_ENTRY (entry), "First name");
return entry;
}
GtkWidget* hildon_entry_new (HildonSizeType size);
Creates a new entry.
size : |
The size of the entry |
| Returns : | a new HildonEntry |
Since 2.2
void hildon_entry_set_text (HildonEntry *entry, const gchar *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 HildonEntry.
entry : |
a HildonEntry |
text : |
the new text |
Since 2.2
const gchar* hildon_entry_get_text (HildonEntry *entry);
Gets the current text in entry.
Note that you must never use gtk_entry_get_text() to get the text
from a HildonEntry.
Also note that placeholder text (set using
hildon_entry_set_placeholder()) is never returned. Only text set by
hildon_entry_set_text() or typed by the user is considered.
entry : |
a HildonEntry |
| Returns : | the text in entry. This text must not be modified or
freed.
|
Since 2.2
void hildon_entry_set_placeholder (HildonEntry *entry, const gchar *text);
Sets the placeholder text in entry to text.
entry : |
a HildonEntry |
text : |
the new text |
Since 2.2