GtkTreeExpander
GtkTreeExpander — Кнопка раскрытия для использования в списке дерева
Функции
| GtkWidget * | gtk_tree_expander_new () |
| GtkWidget * | gtk_tree_expander_get_child () |
| void | gtk_tree_expander_set_child () |
| gpointer | gtk_tree_expander_get_item () |
| GtkTreeListRow * | gtk_tree_expander_get_list_row () |
| void | gtk_tree_expander_set-list-row () |
Свойства
| GtkWidget * | child | Чтение/Запись |
| GObject * | item | Чтение |
| GtkTreeListRow * | list-row | Чтение/Запись |
Действия
| listitem.toggle-expand | ||
| listitem.collapse | ||
| listitem.expand |
Типы и значения
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkTreeExpander
Реализованные интерфейсы
GtkTreeExpander реализует GtkAccessible, GtkBuildable и GtkConstraintTarget.
Включаемые файлы
#include <gtk/gtk.h>
Описание
GtkTreeExpander — виджет, предоставляющий раскрывающую кнопку для списка.
Обычно он размещается как самый нижний дочерний элемент в GtkListView для возможности пользователям раскрывать и сворачивать дочерние элементы в списке с помощью GtkTreeListModel. Он предоставит общие элементы пользовательского интерфейса, жесты и сочетания клавиш для этой цели.
Помимо этого, предоставляются действия «listitem.expand», «listitem.collapse» и «listitem.toggle-expand» для добавления пользовательского интерфейса управления состоянием раскрытия.
Для GtkTreeListModel необходимо установить параметр, чтобы он не был проходным. Тогда он предоставит элементы GtkTreeListRow, которые можно установить с помощью gtk_tree_expander_set_list_row() в раскрытии. Затем раскрытие будет следить за этим элементом строки автоматически. gtk_tree_expander_set_child() устанавливает виджет, отображающий фактическое содержимое строки.
Узлы CSS
GtkTreeExpander имеет ноль или один узел CSS с именем «expander», который должен отображать значок раскрытия. Узел будет :checked при раскрытии. Если узел не раскрывается, вместо этого будет отображаться узел «indent».
Для каждого уровня вложенности добавляется ещё один узел «indent».
Доступность
GtkTreeExpander использует роль GTK_ACCESSIBLE_ROLE_GROUP. Значок раскрытия представлен как GTK_ACCESSIBLE_ROLE_BUTTON, помеченный дочерним элементом раскрытия, и переключение его изменит состояние GTK_ACCESSIBLE_STATE_EXPANDED.
Функции
gtk_tree_expander_new ()
GtkWidget *
gtk_tree_expander_new (void); Создаёт новый GtkTreeExpander
Возвращает
новый GtkTreeExpander
gtk_tree_expander_get_child ()
GtkWidget *
gtk_tree_expander_get_child (GtkTreeExpander *self); Возвращает дочерний виджет, отображаемый self.
Параметры
self | объект GtkTreeExpander |
Возвращает
Дочерний виджет, отображаемый self.
[nullable][transfer none]
gtk_tree_expander_set_child ()
void gtk_tree_expander_set_child (GtkTreeExpander *self,GtkWidget *child);
Устанавливает виджет содержимого для отображения.
Параметры
self | виджет GtkTreeExpander | |
child | виджет GtkWidget, или | [nullable] |
gtk_tree_expander_get_item ()
gpointer
gtk_tree_expander_get_item (GtkTreeExpander *self); Пересылает элемент, установленный в GtkTreeListRow, который управляется self.
Этот вызов по существу эквивалентен вызову:
treeexpander ├── [indent]* ├── [expander] ╰── <child>
Параметры
self | объект GtkTreeExpander |
Возвращает
Элемент строки.
[nullable][transfer full][type GObject]
gtk_tree_expander_get_list_row ()
GtkTreeListRow *
gtk_tree_expander_get_list_row (GtkTreeExpander *self); Возвращает строку списка, управляемую self.
Параметры
self | объект GtkTreeExpander |
Возвращает
Строку списка, отображаемую self.
[nullable][transfer none]
gtk_tree_expander_set_list_row ()
void gtk_tree_expander_set_list_row (GtkTreeExpander *self,GtkTreeListRow *list_row);
Устанавливает строку списка дерева, которую должен управлять этот expander.
Параметры
self | виджет GtkTreeExpander | |
list_row | объект GtkTreeListRow, или | [nullable] |
Типы и значения
GtkTreeExpander
typedef struct _GtkTreeExpander GtkTreeExpander;
Подробные сведения о свойствах
Свойство “child”
“child” GtkWidget *
Дочерний виджет с фактическим содержимым
Владелец: GtkTreeExpander
Флаги: Чтение / Запись
Свойство “item”
“item” GObject *
Элемент, содержащийся в строке этого expander
Владелец: GtkTreeExpander
Флаги: Чтение
Свойство “list-row”
“list-row” GtkTreeListRow *
Строка списка для отслеживания состояния expander
Владелец: GtkTreeExpander
Флаги: Чтение / Запись
Подробные сведения об действиях
Действие “listitem.toggle-expand”
Пытается развернуть expander, если он был свёрнут, или сворачивает его, если он был развернут.
Действие “listitem.collapse”
Сворачивает expander.
Действие “listitem.expand”
Развертывает expander, если это возможно.
См. также
© 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/GtkTreeExpander.html
