Top |
GtkWidget * | gtk_combo_box_text_new () |
GtkWidget * | gtk_combo_box_text_new_with_entry () |
void | gtk_combo_box_text_append_text () |
void | gtk_combo_box_text_insert_text () |
void | gtk_combo_box_text_prepend_text () |
void | gtk_combo_box_text_remove () |
gchar * | gtk_combo_box_text_get_active_text () |
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkComboBox ╰── GtkComboBoxText
GtkComboBoxText implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.
A GtkComboBoxText is a simple variant of GtkComboBox that hides the model-view complexity for simple text-only use cases.
To create a GtkComboBoxText, use gtk_combo_box_text_new()
or
gtk_combo_box_text_new_with_entry()
.
You can add items to a GtkComboBoxText with
gtk_combo_box_text_append_text()
, gtk_combo_box_text_insert_text()
or gtk_combo_box_text_prepend_text()
and remove options with
gtk_combo_box_text_remove()
.
If the GtkComboBoxText contains an entry (via the 'has-entry' property),
its contents can be retrieved using gtk_combo_box_text_get_active_text()
.
The entry itself can be accessed by calling gtk_bin_get_child()
on the
combo box.
The GtkComboBoxText implementation of the GtkBuildable interface supports adding items directly using the <items> element and specifying <item> elements for each item. Each <item> element supports the regular translation attributes "translatable", "context" and "comments".
Example 8. A UI definition fragment specifying GtkComboBoxText items
1 2 3 4 5 6 7 |
<object class="GtkComboBoxText"> <items> <item translatable="yes">Factory</item> <item translatable="yes">Home</item> <item translatable="yes">Subway</item> </items> </object> |
GtkWidget *
gtk_combo_box_text_new (void
);
Creates a new GtkComboBoxText, which is a GtkComboBox just displaying
strings. See gtk_combo_box_entry_new_with_text()
.
Since: 2.24
GtkWidget *
gtk_combo_box_text_new_with_entry (void
);
Creates a new GtkComboBoxText, which is a GtkComboBox just displaying strings. The combo box created by this function has an entry.
Since: 2.24
void gtk_combo_box_text_append_text (GtkComboBoxText *combo_box
,const gchar *text
);
Appends string
to the list of strings stored in combo_box
.
Since: 2.24
void gtk_combo_box_text_insert_text (GtkComboBoxText *combo_box
,gint position
,const gchar *text
);
Inserts string
at position
in the list of strings stored in combo_box
.
Since: 2.24
void gtk_combo_box_text_prepend_text (GtkComboBoxText *combo_box
,const gchar *text
);
Prepends string
to the list of strings stored in combo_box
.
Since: 2.24
void gtk_combo_box_text_remove (GtkComboBoxText *combo_box
,gint position
);
Removes the string at position
from combo_box
.
Since: 2.24
gchar *
gtk_combo_box_text_get_active_text (GtkComboBoxText *combo_box
);
Returns the currently active string in combo_box
, or NULL
if none is selected. If combo_box
contains an entry, this
function will return its contents (which will not necessarily
be an item from the list).
Since: 2.24