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 |
Возвращает
TRUE, если рендерится как радиокнопка, иначе — как флажок
gtk_cell_renderer_toggle_set_radio ()
void gtk_cell_renderer_toggle_set_radio (GtkCellRendererToggle *toggle,gboolean radio);
Если radio равно TRUE, элемент рендеринга отображается как радиокнопка (т.е. кнопка в группе взаимоисключающих переключателей). Если FALSE, отображается как флажок (отдельный булев вариант). Это можно установить глобально для элемента рендеринга или изменить перед рендерингом каждой ячейки в модели (для GtkTreeView вы устанавливаете параметр для каждой строки, используя GtkTreeViewColumn для ассоциации столбцов модели со свойствами элемента рендеринга).
Параметры
toggle | ||
radio |
|
gtk_cell_renderer_toggle_get_active ()
gboolean
gtk_cell_renderer_toggle_get_active (GtkCellRendererToggle *toggle); Возвращает, активен ли элемент рендеринга. См. gtk_cell_renderer_toggle_set_active().
Параметры
toggle |
Возвращает
TRUE, если элемент рендеринга активен.
gtk_cell_renderer_toggle_set_active ()
void gtk_cell_renderer_toggle_set_active (GtkCellRendererToggle *toggle,gboolean setting);
Активирует или деактивирует элемент рендеринга.
Параметры
toggle | ||
setting | значение для установки. |
gtk_cell_renderer_toggle_get_activatable ()
gboolean
gtk_cell_renderer_toggle_get_activatable
(GtkCellRendererToggle *toggle); Возвращает, может ли элемент рендеринга активироваться. См. gtk_cell_renderer_toggle_set_activatable().
Параметры
toggle |
Возвращает
TRUE, если элемент рендеринга может активироваться.
С версии: 2.18
gtk_cell_renderer_toggle_set_activatable ()
void gtk_cell_renderer_toggle_set_activatable (GtkCellRendererToggle *toggle,gboolean setting);
Делает элемент рендеринга активируемым.
Параметры
toggle | ||
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 | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполняется последним
© 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/GtkCellRendererToggle.html