Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties  |  Signals

GtkCellRendererToggle

GtkCellRendererToggle Представляет кнопку переключения в ячейке

Краткое описание

#include <gtk/gtk.h> GtkCellRendererToggle; GtkCellRenderer* gtk_cell_renderer_toggle_new (void); gboolean gtk_cell_renderer_toggle_get_radio (GtkCellRendererToggle *toggle); void gtk_cell_renderer_toggle_set_radio (GtkCellRendererToggle *toggle, gboolean radio); gboolean gtk_cell_renderer_toggle_get_active (GtkCellRendererToggle *toggle); void gtk_cell_renderer_toggle_set_active (GtkCellRendererToggle *toggle, gboolean setting);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkCellRenderer +----GtkCellRendererToggle

Свойства

"activatable" gboolean : Read / Write "active" gboolean : Read / Write "inconsistent" gboolean : Read / Write "indicator-size" gint : Read / Write "radio" gboolean : Read / Write

Сигналы

"toggled" void user_function (GtkCellRendererToggle *cell_renderer, gchar *path, gpointer user_data) : Run last

Описание

GtkCellRendererToggle представляет кнопку переключатель в ячейке. Кнопка изображается как радио- или контроль-кнопка, в зависимости от свойства radio. При активизации издаёт сигнал переключения.

Детали

GtkCellRendererToggle

typedef struct _GtkCellRendererToggle GtkCellRendererToggle;

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 :

Устанавливаемое значение.

Детали свойств

Свойство "activatable"

  "activatable"          gboolean              : Read / Write

Кнопка переключатель может активизироваться.

Значение по умолчанию: TRUE


Свойство "active"

  "active"               gboolean              : Read / Write

Состояние кнопки переключения.

Значение по умолчанию: FALSE


Свойство "inconsistent"

  "inconsistent"         gboolean              : Read / Write

Неопределённое состояние кнопки.

Значение по умолчанию: FALSE


Свойство "indicator-size"

  "indicator-size"       gint                  : Read / Write

Размер флажка или радио-индикатора.

Допустимые значения: >= 0

Значение по умолчанию: 12


Свойство "radio"

  "radio"                gboolean              : Read / Write

Изображает кнопку переключения как радио-кнопку.

Значение по умолчанию: FALSE

Детали сигнала

Сигнал "toggled"

void user_function (GtkCellRendererToggle *cell_renderer, gchar *path, gpointer user_data) : Run last

Сигнал ::toggled когда ячейка переключена.

cell_renderer :

Объект получающий сигнал

path :

Строка представляющая GtkTreePath описывающий расположение события

user_data :

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