GtkCellRendererToggle
GtkCellRendererToggle — Отображает переключатель в ячейке
Функции
Свойства
| gboolean | activatable | Чтение / Запись |
| gboolean | active | Чтение / Запись |
| gboolean | inconsistent | Чтение / Запись |
| gint | indicator-size | Чтение / Запись |
| gboolean | radio | Чтение / Запись |
Сигналы
Типы и значения
| struct | GtkCellRendererToggle |
Иерархия объектов
GObject ╰── GInitiallyUnowned ╰── GtkCellRenderer ╰── GtkCellRendererToggle
Включаемые файлы
#include <gtk/gtk.h>
Описание
GtkCellRendererToggle отображает переключатель в ячейке. Кнопка отображается как радиокнопка или флажок в зависимости от свойства “radio”. При активации, она генерирует сигнал “toggled”.
Функции
gtk_cell_renderer_toggle_new ()
GtkCellRenderer *
gtk_cell_renderer_toggle_new (void); Создаёт новый GtkCellRendererToggle. Настройки отрисовки настраиваются с помощью свойств объекта. Объектные свойства могут быть установлены глобально (с помощью g_object_set()). Также, с помощью GtkTreeViewColumn, можно связать свойство со значением в GtkTreeModel. Например, можно связать свойство «active» рендерера ячейки с булевым значением в модели, что позволит флажку отражать состояние модели.
Возвращает
новый рендер ячейки
gtk_cell_renderer_toggle_get_radio ()
gboolean
gtk_cell_renderer_toggle_get_radio (GtkCellRendererToggle *toggle); Возвращает значение, определяющее, рендерится ли переключатель в виде радиокнопки, а не флажка.
Параметры
toggle | объект GtkCellRendererToggle |
Возвращает
TRUE, если рендерится в виде радиокнопки, а не флажка
gtk_cell_renderer_toggle_set_radio ()
void gtk_cell_renderer_toggle_set_radio (GtkCellRendererToggle *toggle,gboolean radio);
Если radio имеет значение TRUE, рендер ячейки отображается в виде радиокнопки (т.е. переключателя в группе взаимоисключающих переключателей). Если FALSE, рендерится в виде обычного флажка (независимый булев параметр). Это можно установить глобально для рендера ячейки или изменить перед отрисовкой каждой ячейки в модели (для GtkTreeView, вы устанавливаете параметр на строку с помощью GtkTreeViewColumn для ассоциирования столбцов модели со свойствами рендера ячейки).
Параметры
toggle | объект GtkCellRendererToggle | |
radio |
|
gtk_cell_renderer_toggle_get_active ()
gboolean
gtk_cell_renderer_toggle_get_active (GtkCellRendererToggle *toggle); Возвращает, активен ли рендер ячейки. См. gtk_cell_renderer_toggle_set_active().
Параметры
toggle | объект GtkCellRendererToggle |
Возвращает
TRUE, если рендер ячейки активен.
gtk_cell_renderer_toggle_set_active ()
void gtk_cell_renderer_toggle_set_active (GtkCellRendererToggle *toggle,gboolean setting);
Активирует или деактивирует рендер ячейки.
Параметры
toggle | объект GtkCellRendererToggle. | |
setting | значение для установки. |
gtk_cell_renderer_toggle_get_activatable ()
gboolean
gtk_cell_renderer_toggle_get_activatable
(GtkCellRendererToggle *toggle); Возвращает, может ли рендер ячейки быть активирован. См. gtk_cell_renderer_toggle_set_activatable().
Параметры
toggle | объект GtkCellRendererToggle |
Возвращает
TRUE, если рендер ячейки может быть активирован.
С: 2.18
gtk_cell_renderer_toggle_set_activatable ()
void gtk_cell_renderer_toggle_set_activatable (GtkCellRendererToggle *toggle,gboolean setting);
Делает рендер ячейки активируемым.
Параметры
toggle | объект GtkCellRendererToggle. | |
setting | значение для установки. |
С: 2.18
Типы и значения
struct GtkCellRendererToggle
struct GtkCellRendererToggle;
Подробности свойств
Свойство “activatable”
“activatable” gboolean
Кнопка переключателя может быть активирована.
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “active”
“active” gboolean
Состояние переключателя.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “inconsistent”
“inconsistent” gboolean
Состояние несоответствия кнопки.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “indicator-size”
“indicator-size” gint
Размер индикатора флажка или радиокнопки.
Флаги: Чтение / Запись
Допустимые значения: >= 0
Значение по умолчанию: 0
Свойство “radio”
“radio” gboolean
Отображать переключатель как радиокнопку.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Подробности сигналов
Сигнал “toggled”
void user_function (GtkCellRendererToggle *cell_renderer, gchar *path, gpointer user_data)
Сигнал ::toggled генерируется при переключении ячейки.
Приложение должно обновить модель с соответствующим значением для хранения в path. Часто это просто противоположное значение, текущее в path.
Параметры
cell_renderer | объект, получивший сигнал | |
path | строковое представление GtkTreePath, описывающее местоположение события | |
user_data | пользовательские данные, установленные при подключении обработчика сигналов. |
Флаги: Run Last
© 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/GtkCellRendererToggle.html