Spec-Zone.ru › GTK 3.20

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 inconsistent Чтение / Запись
gint indicator-size Чтение / Запись
gboolean radio Чтение / Запись

Сигналы

void toggled Выполнять последним

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

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

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, если рендер ячейки может быть активирован.

С: 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

Spec-Zone.ru

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