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

#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);

определяет как представлять кнопку, как радио-кнопку или как переключатель.

gtk_cell_renderer_toggle_set_radio ()

void        gtk_cell_renderer_toggle_set_radio
                                            (gtkcellrenderertoggle *toggle,
                                             gboolean radio);

если radio равно true, ячейка представления представляет радио-кнопку (то есть переключатели в группе взаимоисключаемы). если false, она представляет флажок (контроль-кнопку) (автономная логическая опция). это может быть установлено глобально для ячейки представления, или меняться перед представлением каждой ячейки в модели (для gtktreeview, вы устанавливаете через строку установок используя gtktreeviewcolumn для связи столбцов модели со свойствами ячейки представления).

gtk_cell_renderer_toggle_get_active ()

gboolean    gtk_cell_renderer_toggle_get_active
                                            (gtkcellrenderertoggle *toggle);

определяет активна ли ячейка представления. смотрите gtk_cell_renderer_toggle_set_active().

gtk_cell_renderer_toggle_set_active ()

void        gtk_cell_renderer_toggle_set_active
                                            (gtkcellrenderertoggle *toggle,
                                             gboolean 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 когда ячейка переключена.