GtkToolButton

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

Функции

GtkToolItem *	gtk_tool_button_new ()
GtkToolItem *	gtk_tool_button_new_from_stock ()
void	gtk_tool_button_set_label ()
const gchar *	gtk_tool_button_get_label ()
void	gtk_tool_button_set_use_underline ()
gboolean	gtk_tool_button_get_use_underline ()
void	gtk_tool_button_set_stock_id ()
const gchar *	gtk_tool_button_get_stock_id ()
void	gtk_tool_button_set_icon_name ()
const gchar *	gtk_tool_button_get_icon_name ()
void	gtk_tool_button_set_icon_widget ()
GtkWidget *	gtk_tool_button_get_icon_widget ()
void	gtk_tool_button_set_label_widget ()
GtkWidget *	gtk_tool_button_get_label_widget ()

Свойства

gchar *	имя-иконки	Чтение/Запись
GtkWidget *	иконка-виджет	Чтение/Запись
gchar *	метка	Чтение/Запись
GtkWidget *	виджет-метки	Чтение/Запись
gchar *	идентификатор-запаса	Чтение/Запись
gboolean	использовать-подчеркивание	Чтение/Запись

Стилизованные свойства

gint

расстояние-иконок

Чтение/Запись

Сигналы

void

нажатие

Действие

Типы и Значения

struct	GtkToolButton
struct	GtkToolButtonClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkToolItem
                        ╰── GtkToolButton
                            ├── GtkMenuToolButton
                            ╰── GtkToggleToolButton

Реализованные интерфейсы

GtkToolButton реализует AtkImplementorIface, GtkBuildable, GtkActivatable и GtkActionable.

Включаемые файлы

#include <gtk/gtk.h>

Описание

GtkToolButtons — это GtkToolItems, содержащие кнопки.

Используйте gtk_tool_button_new() для создания новой 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, иконка определяется элементом набора. В противном случае кнопка не имеет иконки.

CSS-узлы

GtkToolButton имеет единственный CSS-узел с именем toolbutton.

Функции

gtk_tool_button_new ()

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

Создаёт новую кнопку GtkToolButton с содержимым icon_widget и меткой label.

Параметры

label	строка, используемая в качестве метки, или `NULL`.	[allow-none]
icon_widget	виджет, используемый в качестве содержимого кнопки, или `NULL`.	[allow-none]

Возвращает

Новую кнопку GtkToolButton

С: 2.4

gtk_tool_button_new_from_stock ()

GtkToolItem *
gtk_tool_button_new_from_stock (const gchar *stock_id);

gtk_tool_button_new_from_stock устарела с версии 3.10 и не должна использоваться в новом коде.

Используйте gtk_tool_button_new() вместе с gtk_image_new_from_icon_name() вместо этого.

Создаёт новую кнопку GtkToolButton с изображением и текстом из стандартного элемента. Некоторые идентификаторы стандартных элементов имеют макросы препроцессора, такие как 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” имеет эффект только если не переопределено свойством “label-widget”, которое не равно NULL. Если оба свойства “label-widget” и “label” равны NULL, метка определяется свойством “stock-id”. Если свойство “stock-id” также равно NULL, у button не будет метки.

Параметры

button	кнопка GtkToolButton
label	строка, используемая в качестве метки, или `NULL`.	[allow-none]

С: 2.4

gtk_tool_button_get_label ()

const gchar *
gtk_tool_button_get_label (GtkToolButton *button);

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

Параметры

button

кнопка GtkToolButton

Возвращает

Метка или NULL.

[nullable]

С: 2.4

gtk_tool_button_set_use_underline ()

void
gtk_tool_button_set_use_underline (GtkToolButton *button,
                                   gboolean use_underline);

Если установлено, нижняя черта в свойстве метки указывает, что следующий символ должен использоваться в качестве сочетания клавиш в меню переполнения. Например, если свойство метки равно “_Открыть” и use_underline равно TRUE, метка на кнопке инструмента будет “Открыть”, а элемент в меню переполнения будет иметь подчёркнутую “О”.

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

Параметры

button	кнопка GtkToolButton
use_underline	указывает, содержит ли метка кнопки форму “_Открыть”

С: 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_set_stock_id устарела с версии 3.10 и не должна использоваться в новом коде.

Используйте gtk_tool_button_set_icon_name() вместо этого.

Устанавливает имя стандартного элемента. См. gtk_tool_button_new_from_stock(). Свойство stock_id имеет эффект только если не переопределено свойством “label-widget” и “icon-widget”, которые не равны NULL.

Параметры

button	кнопка GtkToolButton
stock_id	имя стандартного элемента, или `NULL`.	[allow-none]

С: 2.4

gtk_tool_button_get_stock_id ()

const gchar *
gtk_tool_button_get_stock_id (GtkToolButton *button);

gtk_tool_button_get_stock_id устарела начиная с версии 3.10 и не должна использоваться в новом коде.

Используйте gtk_tool_button_get_icon_name() вместо этого.

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

Параметры

кнопка

a 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-widget”, “icon-widget” и “stock-id”.

Параметры

кнопка	a GtkToolButton
имя_значка	имя значка темы.	[allow-none]

С: 2.8

gtk_tool_button_get_icon_name ()

const gchar *
gtk_tool_button_get_icon_name (GtkToolButton *button);

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

Параметры

кнопка

a GtkToolButton

Возвращаемое значение

имя значка или NULL, если у кнопки инструмента нет значка темы.

[nullable]

С: 2.8

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

Устанавливает icon в качестве виджета, используемого в качестве значка на button . Если icon_widget равен NULL, значок определяется свойством “stock-id”. Если свойство “stock-id” также равно NULL, у button не будет значка.

Параметры

кнопка	a GtkToolButton
значок_виджет	виджет, используемый в качестве значка, или `NULL`.	[allow-none]

С: 2.4

GtkWidget *
gtk_tool_button_get_icon_widget (GtkToolButton *button);

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

Параметры

кнопка

a GtkToolButton

Возвращаемое значение

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

[nullable][transfer none]

С: 2.4

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 нет метки.

Параметры

кнопка	a GtkToolButton
метка_виджет	виджет, используемый в качестве метки, или `NULL`.	[allow-none]

С: 2.4

GtkWidget *
gtk_tool_button_get_label_widget (GtkToolButton *button);

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

Параметры

кнопка

a GtkToolButton

Возвращаемое значение

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

[nullable][transfer none]

С: 2.4

Типы и значения

struct GtkToolButton

struct GtkToolButton;

struct GtkToolButtonClass

struct GtkToolButtonClass {
  GtkToolItemClass parent_class;

  GType button_type;


  /* signal */
  void       (* clicked)             (GtkToolButton    *tool_item);
};

Члены

GType `button_type`;
`clicked` ()	Сигнал, генерируемый при нажатии кнопки инструмента мышкой или активации с клавиатуры.

Подробности свойств

Свойство `“icon-name”`

  “icon-name”                gchar *

Имя тематического значка, отображаемого на элементе. Это свойство действует только в том случае, если не переопределено свойствами «label-widget», «icon-widget» или «stock-id».

Флаги: Чтение / Запись

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

С версии: 2.8

Свойство `“icon-widget”`

  “icon-widget”              GtkWidget *

Значок виджет, отображаемый в элементе.

Флаги: Чтение / Запись

Свойство `“label”`

  “label”                    gchar *

Текст, отображаемый в элементе.

Флаги: Чтение / Запись

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

Свойство `“label-widget”`

  “label-widget”             GtkWidget *

Виджет, используемый в качестве метки элемента.

Флаги: Чтение / Запись

Свойство `“stock-id”`

  “stock-id”                 gchar *

Значок по умолчанию, отображаемый на элементе.

GtkToolButton:stock-id устарел с версии 3.10 и не должен использоваться в новых кодах.

Используйте «icon-name» вместо него.

Флаги: Чтение / Запись

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

Свойство `“use-underline”`

  “use-underline”            gboolean

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

Флаги: Чтение / Запись

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

Подробности свойств стиля

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

  “icon-spacing”             gint

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

Флаги: Чтение / Запись

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

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

Подробности сигналов

Сигнал `“clicked”`

void
user_function (GtkToolButton *toolbutton,
               gpointer       user_data)

Этот сигнал генерируется при нажатии кнопки инструмента мышкой или активации с клавиатуры.

Параметры

toolbutton	объект, который испустил сигнал
user_data	данные пользователя, заданные при подключении обработчика сигнала.

Флаги: Действие

См. также

GtkToolbar, GtkMenuToolButton, GtkToggleToolButton, GtkRadioToolButton, GtkSeparatorToolItem

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkToolButton.html

GtkToolButton

Функции

Свойства

Стилизованные свойства

Сигналы

Типы и Значения

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

Реализованные интерфейсы

Включаемые файлы

Описание

CSS-узлы

Функции

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 ()

Параметры

Возвращаемое значение

Типы и значения

struct GtkToolButton

struct GtkToolButtonClass

Члены

Подробности свойств

Свойство “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”`

Сигнал `“clicked”`