GtkComboBoxText as GtkBuildable

The GtkComboBoxText implementation of the GtkBuildable interface supports adding items directly using the <items&gt element and specifying <item&gt elements for each item. Each <item&gt element supports the regular translation attributes "translatable", "context" and "comments".

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>

struct GtkComboBoxText

struct GtkComboBoxText;

gtk_combo_box_text_new ()

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

gtk_combo_box_text_new_with_entry ()

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

gtk_combo_box_text_append ()

void                gtk_combo_box_text_append           (GtkComboBoxText *combo_box,
                                                         const gchar *id,
                                                         const gchar *text);

Appends text to the list of strings stored in combo_box. If id is non-NULL then it is used as the ID of the row.

This is the same as calling gtk_combo_box_text_insert() with a position of -1.

Since 2.24

gtk_combo_box_text_prepend ()

void                gtk_combo_box_text_prepend          (GtkComboBoxText *combo_box,
                                                         const gchar *id,
                                                         const gchar *text);

Prepends text to the list of strings stored in combo_box. If id is non-NULL then it is used as the ID of the row.

This is the same as calling gtk_combo_box_text_insert() with a position of 0.

Since 2.24

gtk_combo_box_text_insert ()

void                gtk_combo_box_text_insert           (GtkComboBoxText *combo_box,
                                                         gint position,
                                                         const gchar *id,
                                                         const gchar *text);

Inserts text at position in the list of strings stored in combo_box. If id is non-NULL then it is used as the ID of the row. See "id-column".

If position is negative then text is appended.

Since 3.0

gtk_combo_box_text_append_text ()

void                gtk_combo_box_text_append_text      (GtkComboBoxText *combo_box,
                                                         const gchar *text);

Appends text to the list of strings stored in combo_box.

This is the same as calling gtk_combo_box_text_insert_text() with a position of -1.

Since 2.24

gtk_combo_box_text_prepend_text ()

void                gtk_combo_box_text_prepend_text     (GtkComboBoxText *combo_box,
                                                         const gchar *text);

Prepends text to the list of strings stored in combo_box.

This is the same as calling gtk_combo_box_text_insert_text() with a position of 0.

Since 2.24

gtk_combo_box_text_insert_text ()

void                gtk_combo_box_text_insert_text      (GtkComboBoxText *combo_box,
                                                         gint position,
                                                         const gchar *text);

Inserts text at position in the list of strings stored in combo_box.

If position is negative then text is appended.

This is the same as calling gtk_combo_box_text_insert() with a NULL ID string.

Since 2.24

gtk_combo_box_text_remove ()

void                gtk_combo_box_text_remove           (GtkComboBoxText *combo_box,
                                                         gint position);

Removes the string at position from combo_box.

Since 2.24

gtk_combo_box_text_remove_all ()

void                gtk_combo_box_text_remove_all       (GtkComboBoxText *combo_box);

Removes all the text entries from the combo box.

Since 3.0

gtk_combo_box_text_get_active_text ()

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