CtkComboBoxText as CtkBuildable

The CtkComboBoxText implementation of the CtkBuildable interface supports adding items directly using the <items> element and specifying <item> elements for each item. Each <item> element can specify the “id” corresponding to the appended text and also supports the regular translation attributes “translatable”, “context” and “comments”.

Here is a UI definition fragment specifying CtkComboBoxText items:

1
2
3
4
5
6
7

<object class="CtkComboBoxText">
  <items>
    <item translatable="yes" id="factory">Factory</item>
    <item translatable="yes" id="home">Home</item>
    <item translatable="yes" id="subway">Subway</item>
  </items>
</object>

CSS nodes

1
2
3
4
5

combobox
╰── box.linked
    ├── entry.combo
    ├── button.combo
    ╰── window.popup

CtkComboBoxText has a single CSS node with name combobox. It adds the style class .combo to the main CSS nodes of its entry and button children, and the .linked class to the node of its internal box.

ctk_combo_box_text_new ()

CtkWidget *
ctk_combo_box_text_new (void);

Creates a new CtkComboBoxText, which is a CtkComboBox just displaying strings.

Since: 2.24

ctk_combo_box_text_new_with_entry ()

CtkWidget *
ctk_combo_box_text_new_with_entry (void);

Creates a new CtkComboBoxText, which is a CtkComboBox just displaying strings. The combo box created by this function has an entry.

Since: 2.24

ctk_combo_box_text_append ()

void
ctk_combo_box_text_append (CtkComboBoxText *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 ctk_combo_box_text_insert() with a position of -1.

Since: 2.24

ctk_combo_box_text_prepend ()

void
ctk_combo_box_text_prepend (CtkComboBoxText *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 ctk_combo_box_text_insert() with a position of 0.

Since: 2.24

ctk_combo_box_text_insert ()

void
ctk_combo_box_text_insert (CtkComboBoxText *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

ctk_combo_box_text_append_text ()

void
ctk_combo_box_text_append_text (CtkComboBoxText *combo_box,
                                const gchar *text);

Appends text to the list of strings stored in combo_box .

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

Since: 2.24

ctk_combo_box_text_prepend_text ()

void
ctk_combo_box_text_prepend_text (CtkComboBoxText *combo_box,
                                 const gchar *text);

Prepends text to the list of strings stored in combo_box .

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

Since: 2.24

ctk_combo_box_text_insert_text ()

void
ctk_combo_box_text_insert_text (CtkComboBoxText *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 ctk_combo_box_text_insert() with a NULL ID string.

Since: 2.24

ctk_combo_box_text_remove ()

void
ctk_combo_box_text_remove (CtkComboBoxText *combo_box,
                           gint position);

Removes the string at position from combo_box .

Since: 2.24

ctk_combo_box_text_remove_all ()

void
ctk_combo_box_text_remove_all (CtkComboBoxText *combo_box);

Removes all the text entries from the combo box.

Since: 3.0

ctk_combo_box_text_get_active_text ()

gchar *
ctk_combo_box_text_get_active_text (CtkComboBoxText *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

struct CtkComboBoxText

struct CtkComboBoxText;