GtkComboBoxText

GtkComboBoxText — Простой комбинированный список только с текстом

Функции

GtkWidget *	gtk_combo_box_text_new ()
GtkWidget *	gtk_combo_box_text_new_with_entry ()
void	gtk_combo_box_text_append ()
void	gtk_combo_box_text_prepend ()
void	gtk_combo_box_text_insert ()
void	gtk_combo_box_text_append_text ()
void	gtk_combo_box_text_prepend_text ()
void	gtk_combo_box_text_insert_text ()
void	gtk_combo_box_text_remove ()
void	gtk_combo_box_text_remove_all ()
gchar *	gtk_combo_box_text_get_active_text ()

Типы и значения

struct

GtkComboBoxText

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkComboBox
                        ╰── GtkComboBoxText

Реализованные интерфейсы

GtkComboBoxText реализует AtkImplementorIface, GtkBuildable, GtkCellLayout и GtkCellEditable.

Файлы заголовков

#include <gtk/gtk.h>

Описание

GtkComboBoxText — это простой вариант GtkComboBox, скрывающий сложность модели-представления для простых случаев использования только текста.

Для создания GtkComboBoxText используйте gtk_combo_box_text_new() или gtk_combo_box_text_new_with_entry().

Вы можете добавлять элементы в GtkComboBoxText с помощью gtk_combo_box_text_append_text(), gtk_combo_box_text_insert_text() или gtk_combo_box_text_prepend_text() и удалять варианты с помощью gtk_combo_box_text_remove().

Если GtkComboBoxText содержит поле ввода (через свойство «has-entry»), его содержимое можно получить с помощью gtk_combo_box_text_get_active_text(). Само поле ввода можно получить, вызвав gtk_bin_get_child() в комбинированном списке.

Не следует вызывать gtk_combo_box_set_model() или пытаться упаковать дополнительные ячейки в этот комбинированный список через его интерфейс GtkCellLayout.

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, отображающий только строки.

Возвращает

Новый GtkComboBoxText

С версии: 2.24

gtk_combo_box_text_new_with_entry ()

GtkWidget *
gtk_combo_box_text_new_with_entry (void);

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

Возвращает

новый GtkComboBoxText

С версии: 2.24

gtk_combo_box_text_append ()

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

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

Это то же самое, что вызов gtk_combo_box_text_insert() с позицией -1.

Параметры

combo_box	A GtkComboBoxText
id	строковый идентификатор значения, или `NULL`.	[allow-none]
text	Строка

С версии: 2.24

gtk_combo_box_text_prepend ()

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

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

Это то же самое, что вызов gtk_combo_box_text_insert() с позицией 0.

Параметры

combo_box	A GtkComboBox
id	строковый идентификатор значения, или `NULL`.	[allow-none]
text	строка

С версии: 2.24

gtk_combo_box_text_insert ()

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

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

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

Параметры

combo_box	A GtkComboBoxText
position	Индекс вставки `text`
id	строковый идентификатор значения, или `NULL`.	[allow-none]
text	Строка для отображения

С версии: 3.0

gtk_combo_box_text_append_text ()

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

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

Это то же самое, что вызов gtk_combo_box_text_insert_text() с позицией -1.

Параметры

combo_box	A GtkComboBoxText
text	Строка

С версии: 2.24

gtk_combo_box_text_prepend_text ()

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

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

Это то же самое, что вызов gtk_combo_box_text_insert_text() с позицией 0.

Параметры

combo_box	A GtkComboBox
text	Строка

С версии: 2.24

gtk_combo_box_text_insert_text ()

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

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

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

Это то же самое, что вызов gtk_combo_box_text_insert() со строковым идентификатором NULL.

Параметры

combo_box	A GtkComboBoxText
position	Индекс вставки `text`
text	Строка

С версии: 2.24

gtk_combo_box_text_remove ()

void
gtk_combo_box_text_remove (GtkComboBoxText *combo_box,
                           gint position);

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

Параметры

combo_box	A GtkComboBox
position	Индекс удаляемого элемента

С версии: 2.24

gtk_combo_box_text_remove_all ()

void
gtk_combo_box_text_remove_all (GtkComboBoxText *combo_box);

Удаляет все текстовые элементы из выпадающего списка.

Параметры

combo_box

A GtkComboBoxText

С версии: 3.0

gtk_combo_box_text_get_active_text ()

gchar *
gtk_combo_box_text_get_active_text (GtkComboBoxText *combo_box);

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

Параметры

combo_box

A GtkComboBoxText

Возвращаемое значение

новый выделенный строковый объект, содержащий текущий активный текст. Должен быть освобожден с помощью g_free().

[transfer full]

С: 2.24

Типы и значения

struct GtkComboBoxText

struct GtkComboBoxText;

См. также

GtkComboBox

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkComboBoxText.html