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, содержащий кнопку и небольшую дополнительную кнопку со стрелкой. При нажатии кнопки со стрелкой появляется выпадающее меню.
Используйте gtk_menu_tool_button_new(), чтобы создать новый GtkMenuToolButton.
GtkMenuToolButton как GtkBuildable
Реализация GtkMenuToolButton интерфейса GtkBuildable поддерживает добавление меню путём указания “menu” в качестве атрибута “type” элемента <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 | ||
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);
};
Члены
| Сигнал, генерируемый перед отображением меню. |
Подробности свойств
Подробности сигналов
Сигнал “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.20/GtkMenuToolButton.html
