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

#include <gtk/gtk.h>


            gtktoggletoolbutton;
gtktoolitem* gtk_toggle_tool_button_new     (void);
gtktoolitem* gtk_toggle_tool_button_new_from_stock
                                            (const gchar *stock_id);
void        gtk_toggle_tool_button_set_active
                                            (gtktoggletoolbutton *button,
                                             gboolean is_active);
gboolean    gtk_toggle_tool_button_get_active
                                            (gtktoggletoolbutton *button);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkcontainer
                           +----gtkbin
                                 +----gtktoolitem
                                       +----gtktoolbutton
                                             +----gtktoggletoolbutton
                                                   +----gtkradiotoolbutton

осуществляемые интерфейсы

gtktoggletoolbutton осуществляет atkimplementoriface.

свойства

  "active"               gboolean              : read / write

сигналы

"toggled"   void        user_function      (gtktoggletoolbutton *toggle_tool_button,
                                            gpointer             user_data)               : run first

описание

gtktoggletoolbutton это gtktoolitem который содержит кнопку-переключатель.

используйте gtk_toggle_tool_button_new() для создания нового gtktoggletoolbutton. используйте gtk_toggle_tool_button_new_from_stock() для создания нового gtktoggletoolbutton содержащего готовый элемент.

детали

gtktoggletoolbutton

typedef struct _gtktoggletoolbutton gtktoggletoolbutton;

gtktoggletoolbutton структура содержит только закрытые данные доступ к которым должен осуществляеться с помощью функций описанных ниже.

gtk_toggle_tool_button_new ()

gtktoolitem* gtk_toggle_tool_button_new     (void);

возвращает новый gtktoggletoolbutton

начиная с версии 2.4

gtk_toggle_tool_button_new_from_stock ()

gtktoolitem* gtk_toggle_tool_button_new_from_stock
                                            (const gchar *stock_id);

создаёт новый gtktoggletoolbutton содержащий изображение и текст из готового элемента. некоторые ids заготовок имеют макрос препроцессора как например gtk_stock_ok и gtk_stock_apply.

если stock_id не имя готового элемента, то произойдёт ошибка.

начиная с версии 2.4

gtk_toggle_tool_button_set_active ()

void        gtk_toggle_tool_button_set_active
                                            (gtktoggletoolbutton *button,
                                             gboolean is_active);

устанавливает статус инструментальной кнопки переключателя. установите true если вам нужно нажатый gtktogglebutton 'pressed in', и false отжатый. эти действия выбора издают переключающий сигнал.

начиная с версии 2.4

gtk_toggle_tool_button_get_active ()

gboolean    gtk_toggle_tool_button_get_active
                                            (gtktoggletoolbutton *button);

запрашивает gtktoggletoolbutton и возвращает текущеме состояние. возвращает true если кнопка-переключатель нажата и false если нет.

начиная с версии 2.4

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

свойство "active"

  "active"               gboolean              : read / write

нажата или нет инструментальная кнопка-переключатель.

значение по умолчанию: false

начиная с версии 2.8

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

сигнал "toggled"

void        user_function                  (gtktoggletoolbutton *toggle_tool_button,
                                            gpointer             user_data)               : run first

издаётся при каждом изменении состояния инструментальной кнопки-переключателя.

смотрите также