![]() |
![]() |
![]() |
Netbook Toolkit Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
NbtkEntry; NbtkWidget * nbtk_entry_new (const gchar *text); const gchar * nbtk_entry_get_text (NbtkEntry *entry); void nbtk_entry_set_text (NbtkEntry *entry, const gchar *text); ClutterActor* nbtk_entry_get_clutter_text (NbtkEntry *entry); void nbtk_entry_set_hint_text (NbtkEntry *entry, const gchar *text); const gchar * nbtk_entry_get_hint_text (NbtkEntry *entry); void nbtk_entry_set_primary_icon_from_file (NbtkEntry *entry, const gchar *filename); void nbtk_entry_set_secondary_icon_from_file (NbtkEntry *entry, const gchar *filename);
NbtkEntry is a simple widget for displaying text. It derives from NbtkWidget to add extra style and placement functionality over ClutterText. The internal ClutterText is publicly accessibly to allow applications to set further properties.
NbtkEntry supports the following pseudo style states:
focus: the widget has focus
indeterminate: the widget is showing the hint text
typedef struct _NbtkEntry NbtkEntry;
The contents of this structure is private and should only be accessed using the provided API.
NbtkWidget * nbtk_entry_new (const gchar *text);
Create a new NbtkEntry with the specified entry
|
text to set the entry to |
Returns : |
a new NbtkEntry |
const gchar * nbtk_entry_get_text (NbtkEntry *entry);
Get the text displayed on the entry
|
a NbtkEntry |
Returns : |
the text for the entry. This must not be freed by the application |
void nbtk_entry_set_text (NbtkEntry *entry, const gchar *text);
Sets the text displayed on the entry
|
a NbtkEntry |
|
text to set the entry to |
ClutterActor* nbtk_entry_get_clutter_text (NbtkEntry *entry);
Retrieve the internal ClutterText so that extra parameters can be set
|
a NbtkEntry |
Returns : |
the ClutterText used by NbtkEntry. The entry is owned by the NbtkEntry and should not be unref'ed by the application. |
void nbtk_entry_set_hint_text (NbtkEntry *entry, const gchar *text);
Sets the text to display when the entry is empty and unfocused. When the entry is displaying the hint, it has a pseudo class of "indeterminate". A value of NULL unsets the hint.
|
a NbtkEntry |
|
text to set as the entry hint |
const gchar * nbtk_entry_get_hint_text (NbtkEntry *entry);
Gets the text that is displayed when the entry is empty and unfocused
void nbtk_entry_set_primary_icon_from_file (NbtkEntry *entry, const gchar *filename);
Set the primary icon of the entry to the given filename
|
a NbtkEntry |
|
filename of an icon |
"hint-text"
property"hint-text" gchar* : Read / Write
Text to display when the entry is not focused and the text property is empty.
Default value: NULL