GtkToolButton

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

			GTK+ Reference Manual
Top \| Description \| Object Hierarchy \| Implemented Interfaces \| Properties \| Style Properties \| Signals

GtkToolButton

GtkToolButton GtkToolItem подкласс отображающий кнопки

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

#include <gtk/gtk.h>


            GtkToolButton;
GtkToolItem* gtk_tool_button_new            (GtkWidget *icon_widget,
                                             const gchar *label);

GtkToolItem* gtk_tool_button_new_from_stock (const gchar *stock_id);
void        gtk_tool_button_set_label       (GtkToolButton *button,
                                             const gchar *label);
const gchar* gtk_tool_button_get_label      (GtkToolButton *button);
void        gtk_tool_button_set_use_underline

                                            (GtkToolButton *button,
                                             gboolean use_underline);
gboolean    gtk_tool_button_get_use_underline
                                            (GtkToolButton *button);
void        gtk_tool_button_set_stock_id    (GtkToolButton *button,
                                             const gchar *stock_id);
const gchar* gtk_tool_button_get_stock_id   (GtkToolButton *button);
void        gtk_tool_button_set_icon_name   (GtkToolButton *button,
                                             const gchar *icon_name);
const gchar* gtk_tool_button_get_icon_name  (GtkToolButton *button);
void        gtk_tool_button_set_icon_widget (GtkToolButton *button,
                                             GtkWidget *icon_widget);

GtkWidget*  gtk_tool_button_get_icon_widget (GtkToolButton *button);
void        gtk_tool_button_set_label_widget
                                            (GtkToolButton *button,
                                             GtkWidget *label_widget);

GtkWidget*  gtk_tool_button_get_label_widget
                                            (GtkToolButton *button);

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

  GObject

   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin

                                 +----GtkToolItem
                                       +----GtkToolButton
                                             +----GtkMenuToolButton
                                             +----GtkToggleToolButton

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

GtkToolButton осуществляет AtkImplementorIface.

Свойства

  "icon-name"            gchararray            : Read / Write
  "icon-widget"          GtkWidget             : Read / Write
  "label"                gchararray            : Read / Write
  "label-widget"         GtkWidget             : Read / Write
  "stock-id"             gchararray            : Read / Write
  "use-underline"        gboolean              : Read / Write

Свойства стиля

  "icon-spacing"         gint                  : Read / Write

Сигналы

"clicked"   void        user_function      (GtkToolButton *toolbutton,
                                            gpointer       user_data)       : Run first / Action

Описание

GtkToolButtons является GtkToolItems содержащим кнопки.

Используйте gtk_tool_button_new() для создания нового GtkToolButton. Используйте gtk_tool_button_new_with_stock() для создания нового GtkToolButton содержащего заготовленный пункт.

Ярлык GtkToolButton определяется с помощью свойств "label_widget", "label", и "stock_id". Если "label_widget" не-NULL, то когда этот виджет используется как ярлык. Или, если "label" не-NULL, то когда эта строка используется как ярлык. Или, если "stock_id" не-NULL, ярлык определяется заготовленным пунктом. Иначе, кнопка не имеет ярлыка.

Значок GtkToolButton определяется свойствами "icon_widget" и "stock_id". Если "icon_widget" не-NULL, то когда этот виджет используется как значок. Или, если "stock_id" не-NULL, значок определяется заготовленным пунктом. Иначе, кнопка не имеет значка.

Детали

GtkToolButton

typedef struct _GtkToolButton GtkToolButton;

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

gtk_tool_button_new ()

GtkToolItem* gtk_tool_button_new            (GtkWidget *icon_widget,
                                             const gchar *label);

Создаёт новый GtkToolButton используя icon_widget как значок, а label как ярлык.

`icon_widget` :	Виджет который используется как значок, или `NULL`
`label` :	Строка используется как ярлык, или `NULL`
Возвращает :	Новый GtkToolButton

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

gtk_tool_button_new_from_stock ()

GtkToolItem* gtk_tool_button_new_from_stock (const gchar *stock_id);

Создаёт новый GtkToolButton содержащий изображение и текст из заготовленного пункта. Некоторые id заготовок имеют макрокоманды препроцессора такие как GTK_STOCK_OK и GTK_STOCK_APPLY.

Если stock_id не имя заготовленного пункта происходит ошибка.

`stock_id` :	Имя заготовленного пункта
Возвращает :	Новый GtkToolButton

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

gtk_tool_button_set_label ()

void        gtk_tool_button_set_label       (GtkToolButton *button,
                                             const gchar *label);

Устанавливает label как ярлык используемый для инструментальной кнопки. Свойство "label" имеет эффект только если не перекрывается не-NULL свойством "label_widget". Если оба свойства "label_widget" и "label" являются NULL, ярлык определяется свойством "stock_id". Если "stock_id" свойство тоже NULL, button не имеет ярлыка.

`button` :	GtkToolButton
`label` :	Строка используемая как ярлык, или `NULL`.

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

gtk_tool_button_get_label ()

const gchar* gtk_tool_button_get_label      (GtkToolButton *button);

Возвращает ярлык используемый инструментальной кнопкой, или NULL если инструментальная кнопка не имеет ярлыка. Или используется ярлык из заготовленного пункта. Возвращаемой строкой владеет GTK+ и её не нужно освобождать или модифицировать.

`button` :	GtkToolButton
Возвращает :	Ярлык, или `NULL`

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

gtk_tool_button_set_use_underline ()

void        gtk_tool_button_set_use_underline
                                            (GtkToolButton *button,
                                             gboolean use_underline);

Если установлено, подчеркивание в свойстве label указывает что следующий символ должен использоваться как мнемонический акселератор в меню переполнения. Например, если свойство label "_Open" и use_underline равно TRUE, ярлык на инструментальной кнопке будет "Open" а пункт в меню переполнения будет иметь подчеркнутую 'O'.

Ярлыки показываемые на инструментальных кнопках никогда не отображают мнемоники; это свойство затрагивает только пункты меню в меню переполнения.

`button` :	GtkToolButton
`use_underline` :	Имеет ли ярлык кнопки форму "_Open"

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

gtk_tool_button_get_use_underline ()

gboolean    gtk_tool_button_get_use_underline
                                            (GtkToolButton *button);

Возвращает используется ли подчеркивание в свойстве ярлыка как мнемоник на пункте меню переполнения. Смотрите gtk_tool_button_set_use_underline().

`button` :	GtkToolButton
Возвращает :	`TRUE` если подчеркивание в свойстве ярлыка используется как мнемоник на пункте меню переполнения.

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

gtk_tool_button_set_stock_id ()

void        gtk_tool_button_set_stock_id    (GtkToolButton *button,
                                             const gchar *stock_id);

Устанавливает имя заготовленного пункта. Смотрите gtk_tool_button_new_from_stock(). Свойство stock_id имеет эффект только если не перекрывается не-NULL свойствами "label" и "icon_widget".

`button` :	GtkToolButton
`stock_id` :	Имя заготовленного пункта, или `NULL`

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

gtk_tool_button_get_stock_id ()

const gchar* gtk_tool_button_get_stock_id   (GtkToolButton *button);

Возвращает имя заготовленного пункта. Смотрите gtk_tool_button_set_stock_id(). Возвращаемой строкой владеет GTK+ и её не нужно освобождать или модифицировать.

`button` :	GtkToolButton
Возвращает :	Имя заготовленного пункта для `button`.

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

gtk_tool_button_set_icon_name ()

void        gtk_tool_button_set_icon_name   (GtkToolButton *button,
                                             const gchar *icon_name);

Устанавливает значок для инструментальной кнопки из именованной темы значков. Смотрите документацию по GtkIconTheme. Свойство "icon_name" имеет эффект только если не перекрывается не-NULL свойствами "label", "icon_widget" и "stock_id".

`button` :	GtkToolButton
`icon_name` :	Имя тематического значка

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

gtk_tool_button_get_icon_name ()

const gchar* gtk_tool_button_get_icon_name  (GtkToolButton *button);

Возвращает имя именованного значка для инструментальной кнопки, смотрите gtk_tool_button_set_icon_name().

`button` :	GtkToolButton
Возвращает :	Имя значка или `NULL` если инструментальная кнопка имеет именованный значок

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

gtk_tool_button_set_icon_widget ()

void        gtk_tool_button_set_icon_widget (GtkToolButton *button,
                                             GtkWidget *icon_widget);

Устанавливает icon как виджет используемый как значок на button. Если icon_widget равен NULL значок определяется свойством "stock_id". Если свойство "stock_id" также равно NULL, button не имеет значка.

`button` :	GtkToolButton
`icon_widget` :	Виджет используемый как значок, или `NULL`

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

gtk_tool_button_get_icon_widget ()

GtkWidget*  gtk_tool_button_get_icon_widget (GtkToolButton *button);

Возвращает виджет используемый как значок на button. Смотрите gtk_tool_button_set_icon_widget().

`button` :	GtkToolButton
Возвращает :	Виджет используемый как значок на `button`, или `NULL`.

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

gtk_tool_button_set_label_widget ()

void        gtk_tool_button_set_label_widget
                                            (GtkToolButton *button,
                                             GtkWidget *label_widget);

Устанавливает label_widget как виджет используемый в качестве ярлыка для button. Если label_widget равен NULL свойство "label" используется как ярлык. Если "label" тоже NULL, ярлык определяется с помощью свойства "stock_id". Если и "stock_id" равен NULL, button не имеет ярлыка.

`button` :	GtkToolButton
`label_widget` :	Виджет используемый как ярлык, или `NULL`

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

gtk_tool_button_get_label_widget ()

GtkWidget*  gtk_tool_button_get_label_widget
                                            (GtkToolButton *button);

Возвращает виджет используемый как ярлык на button. Смотрите gtk_tool_button_set_label_widget().

`button` :	GtkToolButton
Возвращает :	Виджет используемый как ярлык на `button`, или `NULL`.

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

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

Свойство "`icon-name`"

  "icon-name"            gchararray            : Read / Write

Имя тематического значка отображаемого на пункте. Это свойство имеет эффект если не перекрывается свойствами "label", "icon_widget" или "stock_id".

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

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

Свойство "`icon-widget`"

  "icon-widget"          GtkWidget             : Read / Write

Виджет значок отображаемый в пункте.

Свойство "`label`"

  "label"                gchararray            : Read / Write

Текст показываемый в пункте.

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

Свойство "`label-widget`"

  "label-widget"         GtkWidget             : Read / Write

Виджет используемый как ярлык пункта.

Свойство "`stock-id`"

  "stock-id"             gchararray            : Read / Write

Заготовленный значок отображаемый на пункте.

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

Свойство "`use-underline`"

  "use-underline"        gboolean              : Read / Write

Если установлено, подчеркивание в свойстве ярлыка указывает что следующий символ мнемонический акселератор в меню переполнения.

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

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

Свойство стиля "`icon-spacing`"

  "icon-spacing"         gint                  : Read / Write

Интервал в пикселах между значком и ярлыком.

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

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

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

Сигнал "clicked"

void        user_function                  (GtkToolButton *toolbutton,
                                            gpointer       user_data)       : Run first / Action

Этот сигнал издаётся когда инструментальная кнопка нажата с помощью мыши или активирована с клавиатуры.

`toolbutton` :	Объект который издает этот сигнал
`user_data` :	Пользовательские данные устанавливаемые при подключении обработчика сигнала.

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

GtkToolbar	Виджет панель инструментов
GtkMenuToolButton	Подкласс GtkToolButton который отображает на панели инструментов кнопку с дополнительным всплывающим меню
GtkToggleToolButton	Подкласс GtkToolButton который отображает кнопку переключатель на панели инструментов
GtkRadioToolButton	Подкласс GtkToolButton который отображает радио-кнопку на панели инструментов
GtkSeparatorToolItem	Подкласс GtkToolItem который разделяет группы пунктов на панели инструментов

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2025 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру

GtkToolButton

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

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

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

Свойства

Свойства стиля

Сигналы

Описание

Детали

GtkToolButton

gtk_tool_button_new ()

gtk_tool_button_new_from_stock ()

gtk_tool_button_set_label ()

gtk_tool_button_get_label ()

gtk_tool_button_set_use_underline ()

gtk_tool_button_get_use_underline ()

gtk_tool_button_set_stock_id ()

gtk_tool_button_get_stock_id ()

gtk_tool_button_set_icon_name ()

gtk_tool_button_get_icon_name ()

gtk_tool_button_set_icon_widget ()

gtk_tool_button_get_icon_widget ()

gtk_tool_button_set_label_widget ()

gtk_tool_button_get_label_widget ()

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

Свойство "icon-name"

Свойство "icon-widget"

Свойство "label"

Свойство "label-widget"

Свойство "stock-id"

Свойство "use-underline"

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

Свойство стиля "icon-spacing"

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

Сигнал "clicked"

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

Свойство "`icon-name`"

Свойство "`icon-widget`"

Свойство "`label`"

Свойство "`label-widget`"

Свойство "`stock-id`"

Свойство "`use-underline`"

Свойство стиля "`icon-spacing`"