Spec-Zone.ru › GTK 4.0

GtkDropDown

GtkDropDown — Выбор элемента из списка

Функции

GtkWidget * gtk_drop_down_new ()
GtkWidget * gtk_drop_down_new_from_strings ()
void gtk_drop_down_set_model ()
GListModel * gtk_drop_down_get_model ()
void gtk_drop_down_set_selected ()
guint gtk_drop_down_get_selected ()
gpointer gtk_drop_down_get_selected_item ()
void gtk_drop_down_set_factory ()
GtkListItemFactory * gtk_drop_down_get_factory ()
void gtk_drop_down_set_list_factory ()
GtkListItemFactory * gtk_drop_down_get_list_factory ()
void gtk_drop_down_set_expression ()
GtkExpression * gtk_drop_down_get_expression ()
void gtk_drop_down_set_enable_search ()
gboolean gtk_drop_down_get_enable_search ()

Свойства

gboolean enable-search Чтение/Запись
GtkExpression * expression Чтение/Запись
GtkListItemFactory * factory Чтение/Запись
GtkListItemFactory * list-factory Чтение/Запись
GListModel * model Чтение/Запись
guint selected Чтение/Запись
GObject * selected-item Чтение

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

GtkDropDown

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkDropDown

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

GtkDropDown реализует GtkAccessible, GtkBuildable и GtkConstraintTarget.

Включаемые файлы

#include <gtk/gtk.h>

Описание

GtkDropDown — это виджет, который позволяет пользователю выбирать элемент из списка вариантов. GtkDropDown отображает выбранный выбор.

Варианты предоставляются GtkDropDown в виде GListModel, а то, как отдельные варианты представляются, определяется GtkListItemFactory. По умолчанию фабрика отображает простые строки.

GtkDropDown умеет получать строки из элементов в GtkStringList; для других моделей вам необходимо предоставить выражение для поиска строк через gtk_drop_down_set_expression().

GtkDropDown может необязательно позволять поиск в всплывающем окне, что полезно, если список вариантов большой. Чтобы включить поле поиска, используйте gtk_drop_down_set_enable_search().

Узлы CSS

GtkDropDown имеет единственный узел CSS с именем dropdown, с кнопкой и всплывающим окном в качестве дочерних узлов.

Доступность

GtkDropDown использует роль GTK_ACCESSIBLE_ROLE_COMBO_BOX.

Функции

gtk_drop_down_new ()

GtkWidget *
gtk_drop_down_new (GListModel *model,
                   GtkExpression *expression);

Создаёт новый GtkDropDown.

Вы можете вызвать gtk_drop_down_set_factory(), чтобы задать способ сопоставления его элементов с виджетами.

Параметры

model

используемая модель или NULL для отсутствия.

 [transfer full][allow-none]

expression

используемое выражение или NULL для отсутствия.

 [transfer full][allow-none]

Возвращает

новый GtkDropDown

gtk_drop_down_new_from_strings ()

GtkWidget *
gtk_drop_down_new_from_strings (const char * const *strings);

Создаёт новый GtkDropDown, заполненный строками из strings.

Параметры

strings

Строки для добавления в выпадающий список.

 [array zero-terminated=1]

Возвращает

новый GtkDropDown

gtk_drop_down_set_model ()

void
gtk_drop_down_set_model (GtkDropDown *self,
                         GListModel *model);

Устанавливает GListModel для использования.

Параметры

self

GtkDropDown

model

используемая модель или NULL для отсутствия.

 [allow-none][transfer none]

gtk_drop_down_get_model ()

GListModel *
gtk_drop_down_get_model (GtkDropDown *self);

Получает модель, предоставляющую отображаемые элементы.

Параметры

self

GtkDropDown

Возвращает

Используемая модель.

[nullable][transfer none]

gtk_drop_down_set_selected ()

void
gtk_drop_down_set_selected (GtkDropDown *self,
                            guint position);

Выделяет элемент по заданной позиции.

Параметры

self

GtkDropDown

position

позиция выделяемого элемента или GTK_INVALID_LIST_POSITION

gtk_drop_down_get_selected ()

guint
gtk_drop_down_get_selected (GtkDropDown *self);

Получает позицию выделенного элемента.

Параметры

self

GtkDropDown

Возвращает

позицию выделенного элемента или GTK_INVALID_LIST_POSITION, если элемент не выделен

gtk_drop_down_get_selected_item ()

gpointer
gtk_drop_down_get_selected_item (GtkDropDown *self);

Возвращает выделенный элемент. Если элемент не выделен, NULL.

Параметры

self

GtkDropDown

Возвращает

Выделенный элемент.

[transfer none][type GObject][nullable]

gtk_drop_down_set_factory ()

void
gtk_drop_down_set_factory (GtkDropDown *self,
                           GtkListItemFactory *factory);

Устанавливает GtkListItemFactory для заполнения элементов списка.

Параметры

self

GtkDropDown

factory

используемый фабрика или NULL для отсутствия.

 [allow-none][transfer none]

gtk_drop_down_get_factory ()

GtkListItemFactory *
gtk_drop_down_get_factory (GtkDropDown *self);

Получает фабрику, используемую для заполнения элементов списка.

Фабрика, возвращённая этой функцией, всегда используется для элемента в кнопке. Она также используется для элементов в всплывающем меню, если “list-factory” не задан.

Параметры

self

GtkDropDown

Возвращает

Используемую фабрику.

[nullable][transfer none]

gtk_drop_down_set_list_factory ()

void
gtk_drop_down_set_list_factory (GtkDropDown *self,
                                GtkListItemFactory *factory);

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

Параметры

self

GtkDropDown

factory

используемую фабрику или NULL для отсутствия.

 [allow-none][transfer none]

gtk_drop_down_get_list_factory ()

GtkListItemFactory *
gtk_drop_down_get_list_factory (GtkDropDown *self);

Получает фабрику, используемую для заполнения элементов списка во всплывающем меню.

Параметры

self

GtkDropDown

Возвращает

Используемую фабрику.

[nullable][transfer none]

gtk_drop_down_set_expression ()

void
gtk_drop_down_set_expression (GtkDropDown *self,
                              GtkExpression *expression);

Устанавливает выражение, которое вычисляется для получения строк из элементов при поиске в всплывающем меню. Выражение должно иметь тип значения G_TYPE_STRING.

Параметры

self

a GtkDropDown

expression

a GtkExpression, или NULL.

[nullable]

gtk_drop_down_get_expression ()

GtkExpression *
gtk_drop_down_get_expression (GtkDropDown *self);

Возвращает выражение, установленное с помощью gtk_drop_down_set_expression().

Параметры

self

a GtkDropDown

Возвращает

a GtkExpression или NULL.

[nullable][transfer none]

gtk_drop_down_set_enable_search ()

void
gtk_drop_down_set_enable_search (GtkDropDown *self,
                                 gboolean enable_search);

Устанавливает, будет ли отображаться поле ввода поиска во всплывающем меню, позволяющее искать элементы в списке.

Обратите внимание, что для работы поиска необходимо установить “expression”.

Параметры

self

a GtkDropDown

enable_search

включить поиск

gtk_drop_down_get_enable_search ()

gboolean
gtk_drop_down_get_enable_search (GtkDropDown *self);

Возвращает, включен ли поиск.

Параметры

self

a GtkDropDown

Возвращает

TRUE, если всплывающее меню включает поле ввода поиска

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

GtkDropDown

typedef struct _GtkDropDown GtkDropDown;

Подробное описание свойств

Свойство “enable-search”

  “enable-search”            gboolean

Определяет, отображать ли поле ввода поиска во всплывающем меню.

Обратите внимание, что для поиска необходимо установить “expression”.

Владелец: GtkDropDown

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “expression”

  “expression”               GtkExpression *

Выражение для вычисления строк, которые нужно сопоставить с поисковым запросом (см. “enable-search”). Если свойство “factory” не задано, выражение также используется для связывания строк с метками, созданными с помощью заводской функции по умолчанию.

[type GtkExpression]

Владелец: GtkDropDown

Флаги: Чтение / Запись

Свойство “factory”

  “factory”                  GtkListItemFactory *

Функция для заполнения элементов списка.

Владелец: GtkDropDown

Флаги: Чтение / Запись

Свойство “list-factory”

  “list-factory”             GtkListItemFactory *

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

Если это свойство не задано, используется свойство “factory”.

Владелец: GtkDropDown

Флаги: Чтение / Запись

Свойство “model”

  “model”                    GListModel *

Модель отображаемых элементов.

Владелец: GtkDropDown

Флаги: Чтение / Запись

Свойство “selected”

  “selected”                 guint

Позиция выбранного элемента в “model”, или GTK_INVALID_LIST_POSITION, если элемент не выбран.

Владелец: GtkDropDown

Флаги: Чтение / Запись

Значение по умолчанию: 4294967295

Свойство “selected-item”

  “selected-item”            GObject *

Выбранный элемент.

Владелец: GtkDropDown

Флаги: Чтение

См. также

GtkComboBox

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkDropDown.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API