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

Реализация GtkBuildable интерфейса GtkComboBoxText поддерживает добавление элементов напрямую с помощью элемента <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	Объект 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	Объект 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	Объект 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	Объект 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	Объект 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	Объект 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	Объект 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.22/GtkComboBoxText.html