Spec-Zone.ru › GTK 3.22

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

a 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

a 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

a GtkCellRendererToggle

Возвращает

TRUE, если элемент рендеринга активен.

gtk_cell_renderer_toggle_set_active ()

void
gtk_cell_renderer_toggle_set_active (GtkCellRendererToggle *toggle,
                                     gboolean setting);

Активирует или деактивирует элемент рендеринга.

Параметры

toggle

a GtkCellRendererToggle.

setting

значение для установки.

gtk_cell_renderer_toggle_get_activatable ()

gboolean
gtk_cell_renderer_toggle_get_activatable
                               (GtkCellRendererToggle *toggle);

Возвращает, может ли элемент рендеринга активироваться. См. gtk_cell_renderer_toggle_set_activatable().

Параметры

toggle

a GtkCellRendererToggle

Возвращает

TRUE, если элемент рендеринга может активироваться.

С версии: 2.18

gtk_cell_renderer_toggle_set_activatable ()

void
gtk_cell_renderer_toggle_set_activatable
                               (GtkCellRendererToggle *toggle,
                                gboolean setting);

Делает элемент рендеринга активируемым.

Параметры

toggle

a 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

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

Флаги: Выполняется последним

© 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

Spec-Zone.ru

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