GtkToolItem

GtkToolItem — Базовый класс виджетов, которые можно добавить в GtkToolShell

Функции

GtkToolItem *	gtk_tool_item_new ()
void	gtk_tool_item_set_homogeneous ()
gboolean	gtk_tool_item_get_homogeneous ()
void	gtk_tool_item_set_expand ()
gboolean	gtk_tool_item_get_expand ()
void	gtk_tool_item_set_tooltip_text ()
void	gtk_tool_item_set_tooltip_markup ()
void	gtk_tool_item_set_use_drag_window ()
gboolean	gtk_tool_item_get_use_drag_window ()
void	gtk_tool_item_set_visible_horizontal ()
gboolean	gtk_tool_item_get_visible_horizontal ()
void	gtk_tool_item_set_visible_vertical ()
gboolean	gtk_tool_item_get_visible_vertical ()
void	gtk_tool_item_set_is_important ()
gboolean	gtk_tool_item_get_is_important ()
PangoEllipsizeMode	gtk_tool_item_get_ellipsize_mode ()
GtkIconSize	gtk_tool_item_get_icon_size ()
GtkOrientation	gtk_tool_item_get_orientation ()
GtkToolbarStyle	gtk_tool_item_get_toolbar_style ()
GtkReliefStyle	gtk_tool_item_get_relief_style ()
gfloat	gtk_tool_item_get_text_alignment ()
GtkOrientation	gtk_tool_item_get_text_orientation ()
GtkWidget *	gtk_tool_item_retrieve_proxy_menu_item ()
GtkWidget *	gtk_tool_item_get_proxy_menu_item ()
void	gtk_tool_item_set_proxy_menu_item ()
void	gtk_tool_item_rebuild_menu ()
void	gtk_tool_item_toolbar_reconfigured ()
GtkSizeGroup *	gtk_tool_item_get_text_size_group ()

Свойства

gboolean	is-important	Чтение / Запись
gboolean	visible-horizontal	Чтение / Запись
gboolean	visible-vertical	Чтение / Запись

Сигналы

gboolean	create-menu-proxy	Выполняется последним
void	toolbar-reconfigured	Выполняется последним

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

struct	GtkToolItem
struct	GtkToolItemClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkToolItem
                        ├── GtkToolButton
                        ╰── GtkSeparatorToolItem

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

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

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

#include <gtk/gtk.h>

Описание

GtkToolItems — это виджеты, которые могут отображаться на панели инструментов. Чтобы создать элемент панели инструментов, содержащий что-то другое, кроме кнопки, используйте gtk_tool_item_new(). Для добавления дочернего виджета в элемент панели инструментов используйте gtk_container_add().

Для элементов панели инструментов, содержащих кнопки, см. классы GtkToolButton, GtkToggleToolButton и GtkRadioToolButton.

Описание виджета панели инструментов см. в классе GtkToolbar, а описание интерфейса оболочки инструментов — в классе GtkToolShell.

Функции

gtk_tool_item_new ()

GtkToolItem *
gtk_tool_item_new (void);

Создаёт новый GtkToolItem

Возвращает

новый GtkToolItem

С момента: 2.4

gtk_tool_item_set_homogeneous ()

void
gtk_tool_item_set_homogeneous (GtkToolItem *tool_item,
                               gboolean homogeneous);

Устанавливает, будет ли tool_item выделен тем же размером, что и другие однородные элементы. В результате все однородные элементы будут иметь одинаковую ширину, равную ширине самого широкого элемента.

Параметры

tool_item	элемент GtkToolItem
homogeneous	будет ли `tool_item` выделен тем же размером, что и другие однородные элементы

С момента: 2.4

gtk_tool_item_get_homogeneous ()

gboolean
gtk_tool_item_get_homogeneous (GtkToolItem *tool_item);

Возвращает, выделен ли tool_item тем же размером, что и другие однородные элементы. См. gtk_tool_item_set_homogeneous().

Параметры

tool_item

элемент GtkToolItem

Возвращает

TRUE , если элемент выделен тем же размером, что и другие однородные элементы.

С момента: 2.4

gtk_tool_item_set_expand ()

void
gtk_tool_item_set_expand (GtkToolItem *tool_item,
                          gboolean expand);

Устанавливает, будет ли tool_item выделен дополнительным местом, когда на панели инструментов есть больше места, чем требуется для элементов. Эффект заключается в увеличении размера элемента при увеличении панели инструментов и уменьшении при её уменьшении.

Параметры

tool_item	элемент GtkToolItem
expand	Выделять ли `tool_item` дополнительным местом

С момента: 2.4

gtk_tool_item_get_expand ()

gboolean
gtk_tool_item_get_expand (GtkToolItem *tool_item);

Возвращает, выделен ли tool_item дополнительным местом. См. gtk_tool_item_set_expand().

Параметры

tool_item

элемент GtkToolItem

Возвращает

TRUE , если tool_item выделен дополнительным местом.

С момента: 2.4

void
gtk_tool_item_set_tooltip_text (GtkToolItem *tool_item,
                                const gchar *text);

Устанавливает текст, который будет отображаться в подсказке для элемента. См. gtk_widget_set_tooltip_text().

Параметры

tool_item	элемент GtkToolItem
text	текст, используемый в качестве подсказки для `tool_item`

С момента: 2.12

void
gtk_tool_item_set_tooltip_markup (GtkToolItem *tool_item,
                                  const gchar *markup);

Устанавливает разметку текста, который будет отображаться в подсказке для элемента. См. gtk_widget_set_tooltip_markup().

Параметры

tool_item	элемент GtkToolItem
markup	текст разметки, используемый в качестве подсказки для `tool_item`

С момента: 2.12

gtk_tool_item_set_use_drag_window ()

void
gtk_tool_item_set_use_drag_window (GtkToolItem *tool_item,
                                   gboolean use_drag_window);

Устанавливает, имеет ли tool_item окно перетаскивания. Когда TRUE элемент tool_item может использоваться в качестве источника перетаскивания с помощью gtk_drag_source_set(). Когда у tool_item есть окно перетаскивания, оно будет перехватывать все события, даже те, которые в противном случае были бы отправлены дочернему элементу tool_item .

Параметры

tool_item	элемент GtkToolItem
use_drag_window	Имеет ли `tool_item` окно перетаскивания.

С момента: 2.4

gtk_tool_item_get_use_drag_window ()

gboolean
gtk_tool_item_get_use_drag_window (GtkToolItem *tool_item);

Возвращает, имеет ли tool_item окно перетаскивания. См. gtk_tool_item_set_use_drag_window().

Параметры

tool_item

элемент GtkToolItem

Возвращает

TRUE , если tool_item использует окно перетаскивания.

С момента: 2.4

gtk_tool_item_set_visible_horizontal ()

void
gtk_tool_item_set_visible_horizontal (GtkToolItem *tool_item,
                                      gboolean visible_horizontal);

Устанавливает, будет ли tool_item отображаться, когда панель инструментов расположена горизонтально.

Параметры

tool_item	элемент GtkToolItem
visible_horizontal	Будет ли `tool_item` отображаться в горизонтальном режиме

С момента: 2.4

gtk_tool_item_get_visible_horizontal ()

gboolean
gtk_tool_item_get_visible_horizontal (GtkToolItem *tool_item);

Возвращает, будет ли tool_item отображаться на панелях инструментов, расположенных горизонтально.

Параметры

tool_item

элемент GtkToolItem

Возвращает

TRUE , если tool_item отображается на горизонтально расположенных панелях инструментов.

С момента: 2.4

gtk_tool_item_set_visible_vertical ()

void
gtk_tool_item_set_visible_vertical (GtkToolItem *tool_item,
                                    gboolean visible_vertical);

Устанавливает, будет ли tool_item отображаться, когда панель инструментов расположена вертикально. Некоторые элементы панели инструментов, такие как текстовые поля, слишком широкие, чтобы быть полезными на вертикально расположенной панели инструментов. Если visible_vertical FALSE, tool_item не будет отображаться на вертикально расположенных панелях инструментов.

Параметры

tool_item	элемент GtkToolItem
visible_vertical	отображаться ли `tool_item` в вертикальном режиме

С момента: 2.4

gtk_tool_item_get_visible_vertical ()

gboolean
gtk_tool_item_get_visible_vertical (GtkToolItem *tool_item);

Возвращает, отображается ли tool_item, когда панель инструментов пришнурована вертикально. См. gtk_tool_item_set_visible_vertical().

Параметры

tool_item

a GtkToolItem

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

Отображается ли tool_item, когда панель инструментов пришнурована вертикально

С: 2.4

gtk_tool_item_set_is_important ()

void
gtk_tool_item_set_is_important (GtkToolItem *tool_item,
                                gboolean is_important);

Устанавливает, должно ли tool_item считаться важным. Класс GtkToolButton использует это свойство для определения, отображать или скрывать метку, когда стиль панели инструментов — GTK_TOOLBAR_BOTH_HORIZ. В результате только те кнопки инструментов, у которых свойство «is_important» установлено, имеют метки, эффект, известный как «приоритетный текст»

Параметры

tool_item	a GtkToolItem
is_important	должен ли элемент инструмента считаться важным

С: 2.4

gtk_tool_item_get_is_important ()

gboolean
gtk_tool_item_get_is_important (GtkToolItem *tool_item);

Возвращает, считается ли tool_item важным. См. gtk_tool_item_set_is_important()

Параметры

tool_item

a GtkToolItem

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

TRUE если tool_item считается важным.

С: 2.4

gtk_tool_item_get_ellipsize_mode ()

PangoEllipsizeMode
gtk_tool_item_get_ellipsize_mode (GtkToolItem *tool_item);

Возвращает режим обрезания, используемый для tool_item . Наследованные классы GtkToolItem должны вызывать эту функцию, чтобы узнать, как следует обрезать текст.

Параметры

tool_item

a GtkToolItem

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

PangoEllipsizeMode указывающий, как следует обрезать текст в tool_item.

С: 2.20

gtk_tool_item_get_icon_size ()

GtkIconSize
gtk_tool_item_get_icon_size (GtkToolItem *tool_item);

Возвращает размер значка, используемый для tool_item . Наследованные классы GtkToolItem должны вызывать эту функцию, чтобы узнать, каких размеров значки они должны использовать.

Параметры

tool_item

a GtkToolItem

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

GtkIconSize указывающий размер значка, используемого для tool_item .

[тип int]

С: 2.4

gtk_tool_item_get_orientation ()

GtkOrientation
gtk_tool_item_get_orientation (GtkToolItem *tool_item);

Возвращает ориентацию, используемую для tool_item . Наследованные классы GtkToolItem должны вызывать эту функцию, чтобы узнать, какого размера значки они должны использовать.

Параметры

tool_item

a GtkToolItem

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

GtkOrientation указывающий ориентацию, используемую для tool_item

С: 2.4

GtkToolbarStyle
gtk_tool_item_get_toolbar_style (GtkToolItem *tool_item);

Возвращает стиль панели инструментов, используемый для tool_item . Наследованные классы GtkToolItem должны вызывать эту функцию в обработчике сигнала GtkToolItem::toolbar_reconfigured, чтобы узнать, в каком стиле отображается панель инструментов, и соответствующим образом изменить себя

Возможные значения:

GTK_TOOLBAR_BOTH, означающее, что элемент инструмента должен отображать и значок, и метку, расположенные вертикально
GTK_TOOLBAR_ICONS, означающее, что панель инструментов отображает только значки
GTK_TOOLBAR_TEXT, означающее, что элемент инструмента должен отображать только текст
GTK_TOOLBAR_BOTH_HORIZ, означающее, что элемент инструмента должен отображать и значок, и метку, расположенные горизонтально

Возвращает

значение GtkOrientation, указывающее ориентацию текста, используемую для tool_item

С: 2.20

GtkWidget *
gtk_tool_item_retrieve_proxy_menu_item
                               (GtkToolItem *tool_item);

Возвращает GtkMenuItem, который был последним установлен с помощью gtk_tool_item_set_proxy_menu_item(), т.е. GtkMenuItem, который будет отображаться в меню переполнения.

Параметры

tool_item

объект GtkToolItem

Возвращает

GtkMenuItem, который будет отображаться в меню переполнения для tool_item .

[transfer none]

С: 2.4

GtkWidget *
gtk_tool_item_get_proxy_menu_item (GtkToolItem *tool_item,
                                   const gchar *menu_item_id);

Если menu_item_id совпадает со строкой, переданной в gtk_tool_item_set_proxy_menu_item(), возвращает соответствующий GtkMenuItem.

Пользовательские подклассы GtkToolItem должны использовать эту функцию для обновления элемента меню, когда GtkToolItem изменяется. Требование, чтобы menu_item_ids совпало, гарантирует, что GtkToolItem не изменит случайно элемент меню, который он не создавал.

Параметры

tool_item	объект GtkToolItem
menu_item_id	строка, используемая для идентификации элемента меню

Возвращает

GtkMenuItem, переданный в gtk_tool_item_set_proxy_menu_item(), если menu_item_ids совпадают.

[transfer none][nullable]

С: 2.4

void
gtk_tool_item_set_proxy_menu_item (GtkToolItem *tool_item,
                                   const gchar *menu_item_id,
                                   GtkWidget *menu_item);

Устанавливает GtkMenuItem, используемый в меню переполнения панели инструментов. menu_item_id используется для идентификации вызывающей функции и должна также использоваться с gtk_tool_item_get_proxy_menu_item().

См. также “create-menu-proxy”.

Параметры

tool_item	объект GtkToolItem
menu_item_id	строка, используемая для идентификации `menu_item`
menu_item	объект GtkMenuItem для использования в меню переполнения или `NULL`.	[nullable]

С: 2.4

void
gtk_tool_item_rebuild_menu (GtkToolItem *tool_item);

Вызов этой функции сигнализирует панели инструментов, что элемент меню переполнения для tool_item изменился. Если меню переполнения отображается при вызове этой функции, меню будет перестроено.

Функция должна вызываться при изменении того, что элемент инструмента будет делать в ответ на сигнал “create-menu-proxy”.

Параметры

tool_item

объект GtkToolItem

С: 2.6

void
gtk_tool_item_toolbar_reconfigured (GtkToolItem *tool_item);

Выдает сигнал “toolbar_reconfigured” на tool_item . Реализации GtkToolbar и GtkToolShell используют эту функцию для уведомления дочерних элементов, когда меняется какой-либо аспект их конфигурации.

Параметры

tool_item

объект GtkToolItem

С: 2.14

gtk_tool_item_get_text-size-group ()

GtkSizeGroup *
gtk_tool_item_get_text_size_group (GtkToolItem *tool_item);

Возвращает группу размеров, используемую для меток в tool_item . Пользовательские подклассы GtkToolItem должны вызывать эту функцию и использовать группу размеров для меток.

Параметры

tool_item

объект GtkToolItem

Возвращает

объект GtkSizeGroup.

[transfer none]

С: 2.20

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

struct GtkToolItem

struct GtkToolItem;

Структура GtkToolItem содержит только закрытые данные. К ней следует обращаться только через описанные ниже функции.

struct GtkToolItemClass

struct GtkToolItemClass {
  GtkBinClass parent_class;

  /* signals */
  gboolean   (* create_menu_proxy)    (GtkToolItem *tool_item);
  void       (* toolbar_reconfigured) (GtkToolItem *tool_item);
};

Члены

`create_menu_proxy` ()	Сигнал генерируется, когда панель инструментов нуждается в информации от tool_item о том, должен ли элемент отображаться в меню переполнения панели инструментов.
`toolbar_reconfigured` ()	Сигнал генерируется, когда изменяется какой-либо параметр панели инструментов, которой принадлежит этот элемент.

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

Свойство `“is-important”`

  “is-important”             gboolean

Определяет, считается ли элемент панели инструментов важным. Если TRUE, кнопки панели инструментов отображают текст в режиме GTK_TOOLBAR_BOTH_HORIZ.

Владелец: GtkToolItem

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

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

Свойство `“visible-horizontal”`

  “visible-horizontal”       gboolean

Определяет, отображается ли элемент панели инструментов, когда панель инструментов находится в горизонтальной ориентации.

Владелец: GtkToolItem

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

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

Свойство `“visible-vertical”`

  “visible-vertical”         gboolean

Определяет, отображается ли элемент панели инструментов, когда панель инструментов находится в вертикальной ориентации.

Владелец: GtkToolItem

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

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

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

Сигнал `“create-menu-proxy”`

gboolean
user_function (GtkToolItem *tool_item,
               gpointer     user_data)

Этот сигнал испускается, когда панели инструментов требуется информация от tool_item о том, должен ли элемент отображаться в меню переполнения панели инструментов. В ответ элемент панели инструментов должен либо

вызвать gtk_tool_item_set_proxy_menu_item() с указателем NULL и вернуть TRUE, чтобы указать, что элемент не должен отображаться в меню переполнения
вызвать gtk_tool_item_set_proxy_menu_item() с новым элементом меню и вернуть TRUE, или
вернуть FALSE, чтобы указать, что сигнал не был обработан элементом. Это означает, что элемент не будет отображаться в меню переполнения, пока позже обработчик не установит элемент меню.

Панель инструментов может кэшировать результат этого сигнала. Когда элемент панели инструментов изменяет способ реагирования на этот сигнал, он должен вызвать gtk_tool_item_rebuild_menu(), чтобы обновить кэш и обеспечить повторное построение меню переполнения панели инструментов.

Параметры

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

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

TRUE если сигнал был обработан, FALSE если нет

Флаги: Run Last

Сигнал `“toolbar-reconfigured”`

void
user_function (GtkToolItem *tool_item,
               gpointer     user_data)

Этот сигнал испускается, когда изменяется какое-либо свойство панели инструментов, элементом которой является данный элемент. Для пользовательских подклассов GtkToolItem стандартный обработчик этого сигнала использует функции

gtk_tool_shell_get_orientation()
gtk_tool_shell_get_style()
gtk_tool_shell_get_icon_size()
gtk_tool_shell_get_relief_style() для определения внешнего вида панели инструментов и соответствующей смены своего вида.

Параметры

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

Флаги: Run Last

См. также

GtkToolbar, GtkToolButton, 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/GtkToolItem.html

GtkToolItem

Функции

Свойства

Сигналы

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

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

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

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

Описание

Функции

gtk_tool_item_new ()

Возвращает

gtk_tool_item_set_homogeneous ()

Параметры

gtk_tool_item_get_homogeneous ()

Параметры

Возвращает

gtk_tool_item_set_expand ()

Параметры

gtk_tool_item_get_expand ()

Параметры

Возвращает

gtk_tool_item_set_tooltip_text ()

Параметры

gtk_tool_item_set_tooltip_markup ()

Параметры

gtk_tool_item_set_use_drag_window ()

Параметры

gtk_tool_item_get_use_drag_window ()

Параметры

Возвращает

gtk_tool_item_set_visible_horizontal ()

Параметры

gtk_tool_item_get_visible_horizontal ()

Параметры

Возвращает

gtk_tool_item_set_visible_vertical ()

Параметры

gtk_tool_item_get_visible_vertical ()

Параметры

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

gtk_tool_item_set_is_important ()

Параметры

gtk_tool_item_get_is_important ()

Параметры

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

gtk_tool_item_get_ellipsize_mode ()

Параметры

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

gtk_tool_item_get_icon_size ()

Параметры

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

gtk_tool_item_get_orientation ()

Параметры

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

gtk_tool_item_get_toolbar_style ()

Параметры

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

gtk_tool_item_get_relief_style ()

Параметры

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

gtk_tool_item_get_text_alignment ()

Параметры

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

gtk_tool_item_get_text_orientation ()

Параметры

Возвращает

gtk_tool_item_retrieve_proxy_menu_item ()

Параметры

Возвращает

gtk_tool_item_get_proxy_menu_item ()

Параметры

Возвращает

gtk_tool_item_set_proxy_menu_item ()

Параметры

gtk_tool_item_rebuild_menu ()

Параметры

gtk_tool_item_toolbar-reconfigured ()

Параметры

gtk_tool_item_get_text-size-group ()

Свойство `“is-important”`

Свойство `“visible-horizontal”`

Свойство `“visible-vertical”`

Сигнал `“create-menu-proxy”`

Сигнал `“toolbar-reconfigured”`