gtktoolbutton

			gtk+ reference manual
top \| description \| object hierarchy \| implemented interfaces \| properties \| style properties \| signals

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 который разделяет группы пунктов на панели инструментов

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`"