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 *	icon-name	Чтение / Запись
GtkWidget *	icon-widget	Чтение / Запись
gchar *	label	Чтение / Запись
GtkWidget *	label-widget	Чтение / Запись
gchar *	stock-id	Чтение / Запись
gboolean	use-underline	Чтение / Запись

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

gint

icon-spacing

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

Сигналы

void

clicked

Действие

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

struct	GtkToolButton
struct	GtkToolButtonClass

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

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

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

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

Файлы заголовков

#include <gtk/gtk.h>

Описание

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

Для создания новой GtkToolButton используйте gtk_tool_button_new().

Текст 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 в качестве метки, используемой для кнопки инструмента. Свойство «метка» имеет эффект только если не переопределено свойством, не являющимся NULL «виджет-метки». Если оба свойства «виджет-метки» и «метка» имеют значение NULL, метка определяется свойством «идентификатор-запаса». Если свойство «идентификатор-запаса» также имеет значение 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);

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

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

Параметры

button	GtkToolButton
use_underline	является ли метка кнопки в форме «_Открыть»

С версии: 2.4

gtk_tool_button_get_use_underline ()

gboolean
gtk_tool_button_get_use_underline (GtkToolButton *button);

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

Параметры

button

GtkToolButton

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

TRUE если подчеркнутые буквы в свойстве метки используются в качестве mnemonics для элементов меню в контекстном меню.

С версии: 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 имеет эффект только если не переопределено не-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
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

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

структура GtkToolButton

struct GtkToolButton;

структура 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.20/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 ()

Параметры

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

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

структура GtkToolButton

структура 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”`