Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties  |  Signals

GtkToggleToolButton

GtkToggleToolButton GtkToolItem содержащий кнопку-переключатель

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

#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

Возвращает :

Вновь созданный 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 не имя готового элемента, то произойдёт ошибка.

stock_id :

Имя готового элемента

Возвращает :

Новый GtkToggleToolButton

Начиная с версии 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 отжатый. Эти действия выбора издают переключающий сигнал.

button :

GtkToggleToolButton

is_active :

Должна ли button быть активной

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


gtk_toggle_tool_button_get_active ()

gboolean gtk_toggle_tool_button_get_active (GtkToggleToolButton *button);

Запрашивает GtkToggleToolButton и возвращает текущеме состояние. Возвращает TRUE если кнопка-переключатель нажата и FALSE если нет.

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

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

toggle_tool_button :

Объект издающий сигнал

user_data :

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

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

GtkToolbar

Виджет панель инструментов

GtkToolButton

Родительский класс GtkMenuToolButton. Свойства "label_widget", "label", "icon_widget", и "stock_id" GtkToolButton определяют ярлык и значок используемый для GtkMenuToolButtons.

GtkSeparatorToolItem

Подкласс GtkToolItem который разделяет группы пунктов в панели инструментов.