![]() |
![]() |
![]() |
Hildon 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); void hildon_touch_selector_entry_set_input_mode (HildonTouchSelectorEntry *selector, HildonGtkInputMode input_mode); HildonGtkInputMode hildon_touch_selector_entry_get_input_mode (HildonTouchSelectorEntry *selector); HildonEntry* hildon_touch_selector_entry_get_entry (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 HildonEntry. Items can also
be searched and selected by typing in the entry. For more specific use cases,
the HildonEntry can be accessed directly with hildon_touch_selector_get_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 (void);
Creates a HildonTouchSelectorEntry
Returns : | A new HildonTouchSelectorEntry |
Since 2.2
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 |
Since 2.2
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 |
Since 2.2
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. |
Since 2.2
void hildon_touch_selector_entry_set_input_mode (HildonTouchSelectorEntry *selector, HildonGtkInputMode input_mode);
Sets the input mode to be used in the GtkEntry in selector
. See hildon_gtk_entry_set_input_mode()
for details.
It must be noted that not all input modes are available for the
entry in selector
. In particular,
HILDON_GTK_INPUT_MODE_MULTILINE
, HILDON_GTK_INPUT_MODE_INVISIBLE
,
HILDON_GTK_INPUT_MODE_DICTIONARY
are disabled, since these are irrelevant
for HildonTouchSelectorEntry.
selector : |
a HildonTouchSelectorEntry |
input_mode : |
HildonGtkInputMode mask |
Since 2.2
HildonGtkInputMode hildon_touch_selector_entry_get_input_mode (HildonTouchSelectorEntry *selector);
Gets the input mode used in the GtkEntry in selector
. See hildon_gtk_entry_get_input_mode()
for details.
selector : |
a HildonTouchSelectorEntry |
Returns : | a mask of HildonGtkInputMode |
Since 2.2
HildonEntry* hildon_touch_selector_entry_get_entry (HildonTouchSelectorEntry *selector);
Provides access to the HildonEntry in selector
. Use to programmatically
change the contents in entry or modify its behavior.
selector : |
a HildonTouchSelectorEntry. |
Returns : | a HildonEntry. |
Since 2.2
"text-column"
property"text-column" gint : Read / Write
A column in the data source model to get the strings from.
This property is deprecated. Use HildonTouchSelectorColumn:text-column
instead. Use hildon_touch_selector_entry_set_text_column()
and
hildon_touch_selector_entry_get_text_column()
to manage it.
Allowed values: >= -1
Default value: -1
Since maemo 2.2