GtkComboBoxText

GtkComboBoxText как GtkBuildable

Реализация GtkComboBoxText интерфейса GtkBuildable поддерживает добавление элементов напрямую с помощью элемента <items> и указания элементов <item> для каждого элемента. Каждый элемент <item> может указывать «id», соответствующий добавленному тексту, а также поддерживает обычные атрибуты перевода «translatable», «context» и «comments».

Вот фрагмент определения пользовательского интерфейса, указывающий элементы GtkComboBoxText:

Узлы CSS

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

GtkComboBoxText имеет один узел CSS с именем combobox. Он добавляет класс стиля .combo к основным узлам CSS своих дочерних элементов ввода и кнопки, и класс .linked к узлу своего внутреннего поля.

gtk_combo_box_text_new ()

GtkWidget *
gtk_combo_box_text_new (void);

Создаёт новый GtkComboBoxText, который является GtkComboBox, просто отображающим строки.

gtk_combo_box_text_new_with_entry ()

GtkWidget *
gtk_combo_box_text_new_with_entry (void);

Создаёт новый GtkComboBoxText, который является GtkComboBox, просто отображающим строки. Созданный с помощью этой функции combobox имеет поле ввода.

gtk_combo_box_text_append ()

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

Добавляет text в список строк, хранящихся в combo_box . Если id не NULL, то оно используется в качестве идентификатора строки.

Это эквивалентно вызову gtk_combo_box_text_insert() с позицией -1.

gtk_combo_box_text_prepend ()

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

Вставляет text в начало списка строк, хранящихся в combo_box . Если id не NULL, то оно используется в качестве идентификатора строки.

Это эквивалентно вызову gtk_combo_box_text_insert() с позицией 0.

gtk_combo_box_text_insert ()

void
gtk_combo_box_text_insert (GtkComboBoxText *combo_box,
                           int position,
                           const char *id,
                           const char *text);

Вставляет text на позицию position в список строк, хранящихся в combo_box . Если id не NULL, то оно используется в качестве идентификатора строки. Смотрите «id-column».

Если position отрицательно, то text добавляется в конец.

gtk_combo_box_text_append_text ()

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

Добавляет text в список строк, хранящихся в combo_box .

Это эквивалентно вызову gtk_combo_box_text_insert_text() с позицией -1.

gtk_combo_box-text-prepend-text ()

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

Добавляет text в начало списка строк, хранящихся в combo_box .

Это эквивалентно вызову gtk_combo_box_text_insert_text() с позицией 0.

gtk_combo_box_text_insert_text ()

void
gtk_combo_box_text_insert_text (GtkComboBoxText *combo_box,
                                int position,
                                const char *text);

Вставляет text на позицию position в список строк, хранящихся в combo_box .

Если position отрицательно, то text добавляется в конец.

Это эквивалентно вызову gtk_combo_box_text_insert() со строковым идентификатором NULL.

gtk_combo_box_text_remove ()

void
gtk_combo_box_text_remove (GtkComboBoxText *combo_box,
                           int position);

Удаляет строку на позиции position из combo_box .

gtk_combo_box_text_remove_all ()

void
gtk_combo_box_text_remove_all (GtkComboBoxText *combo_box);

Удаляет все текстовые записи из combobox.

gtk_combo_box_text_get_active_text ()

char *
gtk_combo_box_text_get_active_text (GtkComboBoxText *combo_box);

Возвращает текущую активную строку в combo_box, или NULL, если ничего не выбрано. Если combo_box содержит запись, эта функция вернёт её содержимое (которое необязательно является элементом списка).

GtkComboBoxText

typedef struct _GtkComboBoxText GtkComboBoxText;