GtkCellRendererToggle
GtkCellRendererToggle — Отображает переключатель в ячейке
Функции
| GtkCellRenderer * | gtk_cell_renderer_toggle_new () |
| gboolean | gtk_cell_renderer_toggle_get_radio () |
| void | gtk_cell_renderer_toggle_set_radio () |
| gboolean | gtk_cell_renderer_toggle_get_active () |
| void | gtk_cell_renderer_toggle_set_active () |
| gboolean | gtk_cell_renderer_toggle_get_activatable () |
| void | gtk_cell_renderer_toggle_set_activatable () |
Свойства
| gboolean | activatable | Чтение/Запись |
| gboolean | active | Чтение/Запись |
| gboolean | несогласованный | Чтение/Запись |
| gboolean | радио | Чтение/Запись |
Сигналы
| void | toggled | Выполнить последним |
Типы и значения
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkCellRenderer
╰── GtkCellRendererToggle
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkCellRendererToggle отображает переключатель в ячейке. Переключатель отображается как радиокнопка или флажок, в зависимости от свойства «радио». При активации он отправляет сигнал «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 , если виджет ячейки может быть активирован.
gtk_cell_renderer_toggle_set_activatable ()
void gtk_cell_renderer_toggle_set_activatable (GtkCellRendererToggle *toggle,gboolean setting);
Делает виджет ячейки активируемым.
Параметры
toggle | объект GtkCellRendererToggle. | |
setting | устанавливаемое значение. |
Типы и значения
GtkCellRendererToggle
typedef struct _GtkCellRendererToggle GtkCellRendererToggle;
Подробности свойств
Свойство “activatable”
“activatable” gboolean
Переключатель может быть активирован.
Владелец: GtkCellRendererToggle
Флаги: Чтение / Запись
Значение по умолчанию: TRUE
Свойство “active”
“active” gboolean
Состояние переключения кнопки.
Владелец: GtkCellRendererToggle
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “inconsistent”
“inconsistent” gboolean
Состояние несоответствия кнопки.
Владелец: GtkCellRendererToggle
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Свойство “radio”
“radio” gboolean
Отобразить переключатель как радиокнопку.
Владелец: GtkCellRendererToggle
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Подробности сигналов
Сигнал “toggled”
void user_function (GtkCellRendererToggle *cell_renderer, char *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-old.gnome.org/gtk4/4.0/GtkCellRendererToggle.html