Spec-Zone.ru › GTK 4.0

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 Выполнить последним

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

GtkCellRendererToggle

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

    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

TRUE для того, чтобы переключатель отображался как радиокнопка

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

Spec-Zone.ru

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