GtkMenuToolButton
GtkMenuToolButton — Элемент GtkToolItem, содержащий кнопку с дополнительным выпадающим меню
Функции
Сигналы
| void | отображение-меню | Выполняется первым |
Типы и значения
| struct | GtkMenuToolButton |
| struct | GtkMenuToolButtonClass |
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkContainer
╰── GtkBin
╰── GtkToolItem
╰── GtkToolButton
╰── GtkMenuToolButton
Реализованные интерфейсы
GtkMenuToolButton реализует AtkImplementorIface, GtkBuildable, GtkActivatable и GtkActionable.
Файлы заголовков
#include <gtk/gtk.h>
Описание
Элемент GtkMenuToolButton — это GtkToolItem, содержащий кнопку и небольшую дополнительную кнопку со стрелкой. При нажатии на кнопку со стрелкой появляется выпадающее меню.
Для создания нового элемента GtkMenuToolButton используйте gtk_menu_tool_button_new().
GtkMenuToolButton как GtkBuildable
Реализация GtkBuildable в GtkMenuToolButton поддерживает добавление меню с помощью атрибута “type” со значением “menu” в элементе <child>.
Пример фрагмента определения интерфейса с меню:
<object class="GtkMenuToolButton">
<child type="menu">
<object class="GtkMenu"/>
</child>
</object>Функции
gtk_menu_tool_button_new ()
GtkToolItem * gtk_menu_tool_button_new (GtkWidget *icon_widget,const gchar *label);
Создаёт новую кнопку GtkMenuToolButton, используя icon_widget в качестве иконки и label в качестве метки.
Параметры
icon_widget | виджет, который будет использоваться как виджет иконки, или | [allow-none] |
label | строка, которая будет использоваться как метка, или | [allow-none] |
Возвращаемое значение
новая GtkMenuToolButton
С: 2.6
gtk_menu_tool_button_new_from_stock ()
GtkToolItem *
gtk_menu_tool_button_new_from_stock (const gchar *stock_id); gtk_menu_tool_button_new_from_stock устарела с версии 3.10 и не должна использоваться в новых кодах.
Используйте gtk_menu_tool_button_new() вместо неё.
Создаёт новую GtkMenuToolButton. Новая GtkMenuToolButton будет содержать иконку и метку из элемента набора stock_id.
Параметры
stock_id | имя элемента набора |
Возвращаемое значение
новая GtkMenuToolButton
С: 2.6
gtk_menu_tool_button_set_menu ()
void gtk_menu_tool_button_set_menu (GtkMenuToolButton *button,GtkWidget *menu);
Устанавливает GtkMenu, который отображается при нажатии на стрелку. Если menu равен NULL, кнопка стрелки становится неактивной.
Параметры
button | ||
menu | GtkMenu, связанный с GtkMenuToolButton |
С: 2.6
gtk_menu_tool_button_get_menu ()
GtkWidget *
gtk_menu_tool_button_get_menu (GtkMenuToolButton *button); Возвращает GtkMenu, связанный с GtkMenuToolButton.
Параметры
button |
С: 2.6
gtk_menu_tool_button_set_arrow_tooltip_text ()
void gtk_menu_tool_button_set_arrow_tooltip_text (GtkMenuToolButton *button,const gchar *text);
Устанавливает текст всплывающей подсказки для кнопки стрелки, которая отображает меню. См. gtk_tool_item_set_tooltip_text() для установки всплывающей подсказки для всей GtkMenuToolButton.
Параметры
button | ||
text | текст всплывающей подсказки для кнопки стрелки |
С: 2.12
gtk_menu_tool_button_set_arrow_tooltip_markup ()
void gtk_menu_tool_button_set_arrow_tooltip_markup (GtkMenuToolButton *button,const gchar *markup);
Устанавливает разметку текста всплывающей подсказки для кнопки стрелки, которая отображает меню. См. gtk_tool_item_set_tooltip_text() для установки всплывающей подсказки для всей GtkMenuToolButton.
Параметры
button | ||
markup | разметка текста всплывающей подсказки для кнопки стрелки |
С: 2.12
Типы и значения
struct GtkMenuToolButton
struct GtkMenuToolButton;
struct GtkMenuToolButtonClass
struct GtkMenuToolButtonClass {
GtkToolButtonClass parent_class;
void (*show_menu) (GtkMenuToolButton *button);
};
Члены
| Сигнал, генерируемый перед отображением меню. |
Подробное описание свойств
Свойство “menu”
“menu” GtkMenu *
Выпадающее меню.
Владелец: GtkMenuToolButton
Флаги: Чтение / Запись
Подробное описание сигналов
Сигнал “show-menu”
void user_function (GtkMenuToolButton *button, gpointer user_data)
Сигнал ::show-menu генерируется перед отображением меню.
Он может использоваться для динамической генерации меню, используя gtk_menu_tool_button_set_menu().
Обратите внимание, что даже если вы генерируете меню динамически, вы должны предварительно установить пустое меню на GtkMenuToolButton, так как кнопка стрелки становится неактивной, если меню не установлено.
Параметры
button | объект, на котором генерируется сигнал | |
user_data | пользовательские данные, установленные при подключении обработчика сигнала. |
Флаги: Выполняется первым
См. также
© 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/GtkMenuToolButton.html
