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

Свойства

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

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

int

расстояние-между-иконками

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

Сигналы

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 определяется свойствами “виджет-метки”, “метка” и “идентификатор-запаса”. Если “виджет-метки” не NULL, то используется этот виджет. В противном случае, если “метка” не NULL, используется эта строка. В противном случае, если “идентификатор-запаса” не NULL, метка определяется по элементу запаса. В противном случае кнопка не имеет метки.

Иконка GtkToolButton определяется свойствами “виджет-иконки” и “идентификатор-запаса”. Если “виджет-иконки” не NULL, то используется этот виджет. В противном случае, если “идентификатор-запаса” не NULL, иконка определяется по элементу запаса. В противном случае у кнопки нет иконки.

Узлы CSS

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

Функции

gtk_tool_button_new ()

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

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

Параметры

метка	строка, используемая в качестве метки, или `NULL`.	[allow-none]
элемент_виджета	виджет, используемый в качестве содержимого кнопки, или `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 не является именем элемента стандартного набора.

Параметры

идентификатор_элемента

имя элемента стандартного набора

Возвращает

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

С: 2.4

gtk_tool_button_set_label ()

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

Устанавливает label в качестве метки, используемой для инструментальной кнопки. Свойство «метка» действует только в том случае, если оно не переопределено свойством не-NULL «виджет_метки». Если оба свойства «виджет_метки» и «метка» NULL, метка определяется свойством «идентификатор_элемента». Если свойство «идентификатор_элемента» также NULL, у button не будет метки.

Параметры

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

С: 2.4

gtk_tool_button_get_label ()

const gchar *
gtk_tool_button_get_label (GtkToolButton *button);

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

Параметры

кнопка

кнопка 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, метка на инструментальной кнопке будет «Открыть», а пункт в выпадающем меню будет иметь подчеркнутую «О».

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

Параметры

кнопка	кнопка GtkToolButton
использовать_подчеркивание	указывает, содержит ли метка кнопки форму «_Открыть»

С: 2.4

gtk_tool_button_get_use_underline ()

gboolean
gtk_tool_button_get_use_underline (GtkToolButton *button);

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

Параметры

кнопка

кнопка 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(). Свойство идентификатора_элемента действует только если оно не переопределено не-NULL свойствами «виджет_метки» и «виджет_иконки».

Параметры

кнопка	кнопка GtkToolButton
идентификатор_элемента	имя элемента стандартного набора, или `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+ и не должна освобождаться или изменяться.

Параметры

кнопка

кнопка 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
widget_значка	виджет, используемый в качестве значка, или `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
widget_метки	виджет, используемый в качестве метки, или `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”                char *

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

Владелец: GtkToolButton

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

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

С версии: 2.8

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

  “icon-widget”              GtkWidget *

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

Владелец: GtkToolButton

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

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

  “label”                    char *

Текст для отображения в элементе.

Владелец: GtkToolButton

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

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

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

  “label-widget”             GtkWidget *

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

Владелец: GtkToolButton

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

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

  “stock-id”                 char *

Отображаемый значок-заготовка на элементе.

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

Используйте “icon-name” вместо этого.

Владелец: GtkToolButton

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

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

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

  “use-underline”            gboolean

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

Владелец: GtkToolButton

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

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

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

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

  “icon-spacing”             int

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

Владелец: GtkToolButton

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

Разрешенные значения: >= 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.24/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”`