GtkMenuToolButton
GtkMenuToolButton — Элемент GtkToolItem, содержащий кнопку с дополнительным выпадающим меню
Функции
Сигналы
Типы и значения
| 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 поддерживает добавление меню путём указания атрибута “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 в качестве метки.
Параметры
Возвращает
новый объект 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 | объект GtkMenuToolButton | |
menu | GtkMenu, связанный с объектом GtkMenuToolButton |
С: 2.6
gtk_menu_tool_button_get_menu ()
GtkWidget *
gtk_menu_tool_button_get_menu (GtkMenuToolButton *button); Получает GtkMenu, связанный с объектом GtkMenuToolButton.
Параметры
button | объект GtkMenuToolButton |
С: 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 | объект GtkMenuToolButton | |
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 | объект GtkMenuToolButton | |
markup | разметка текста всплывающей подсказки для кнопки стрелки |
С: 2.12
Типы и значения
struct GtkMenuToolButton
struct GtkMenuToolButton;
struct GtkMenuToolButtonClass
struct GtkMenuToolButtonClass {
GtkToolButtonClass parent_class;
void (*show_menu) (GtkMenuToolButton *button);
};
Члены
| Сигнал, генерируемый перед отображением меню. |
Подробности свойств
Подробности сигналов
Сигнал “show-menu”
void user_function (GtkMenuToolButton *button, gpointer user_data)
Сигнал ::show-menu генерируется перед отображением меню.
Он может использоваться для динамической генерации меню, используя gtk_menu_tool_button_set_menu().
Обратите внимание, что даже если вы генерируете меню динамически таким образом, вам необходимо предварительно установить пустое меню на GtkMenuToolButton, так как кнопка стрелки становится неактивной, если меню не установлено.
Параметры
button | объект, на котором генерируется сигнал | |
user_data | данные пользователя, установленные при подключении обработчика сигнала. |
Флаги: Run First
См. также
© 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/GtkMenuToolButton.html
