|
|
|
hildon 2.1.24 Reference Manual | |
|---|---|---|---|---|
HildonTouchSelectorEntryHildonTouchSelectorEntry — A selector widget with one column and a text entry |
HildonTouchSelectorEntry;
GtkWidget* hildon_touch_selector_entry_new (void);
GtkWidget* hildon_touch_selector_entry_new_text
(void);
void hildon_touch_selector_entry_set_text_column
(HildonTouchSelectorEntry *selector,
gint text_column);
gint hildon_touch_selector_entry_get_text_column
(HildonTouchSelectorEntry *selector);
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkBox
+----GtkVBox
+----HildonTouchSelector
+----HildonTouchSelectorEntry
HildonTouchSelectorEntry is a selector widget with a text entry, similar in behaviour to GtkComboBoxEntry, that allows user to select an item from a predefined list or to enter a different one in a GtkEntry. Items can also be searched and selected by typing in the entry.
The main difference between the GtkTreeModel used by HildonTouchSelector
and HildonTouchSelectorEntry, is that the latter must always include a text
column. You should set it with hildon_touch_selector_entry_set_text_column().
Normally, you would use HildonTouchSelectorEntry together with a HildonPickerDialog activated from a button. For the most common cases, you should use HildonPickerButton.
If you only need a text only, one column selector, you can create it with
hildon_touch_selector_entry_new_text() and populate it with
hildon_touch_selector_append_text(), hildon_touch_selector_prepend_text(),
and hildon_touch_selector_insert_text().
GtkWidget* hildon_touch_selector_entry_new_text
(void);
Creates a HildonTouchSelectorEntry with a single text column that
can be populated conveniently through hildon_touch_selector_append_text(),
hildon_touch_selector_prepend_text(), hildon_touch_selector_insert_text().
| Returns : | A new HildonTouchSelectorEntry |
void hildon_touch_selector_entry_set_text_column
(HildonTouchSelectorEntry *selector,
gint text_column);
Sets the model column which touch selector box should use to get strings
from to be text_column.
selector : |
A HildonTouchSelectorEntry |
text_column : |
A column in model to get the strings from |
gint hildon_touch_selector_entry_get_text_column
(HildonTouchSelectorEntry *selector);
Gets the text column that selector is using as a text column.
selector : |
A HildonTouchSelectorEntry |
| Returns : | the number of the column used as a text column. |