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, отображающий только строки. Создаваемый с помощью этой функции combobox содержит поле ввода.

Возвращает

новый 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

Since: 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]

Since: 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.20/GtkComboBoxText.html