菜单按钮¶

菜单按钮允许您在用户激活按钮时显示菜单。

菜单使用 GMenu 定义，菜单中的每个项目将激活与其关联的动作。

界面指南

GtkWidget *button = gtk_menu_button_new ();

gtk_menu_button_set_icon_name (GTK_MENU_BUTTON (button), "open-menu-symbolic");

// "menu" is defined elsewhere
gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (button), menu);

# "menu" is defined elsewhere
button = Gtk.MenuButton(icon_name="open-menu-symbolic", menu_model=menu)

// "menu" is defined elsewhere
var button = new Gtk.MenuButton () {
    icon_name = "open-menu-symbolic",
    menu_model = menu
};

// "menu" is defined elsewhere
const button = new Gtk.MenuButton({
  icon_name: "open-menu-symbolic",
  menu_model: menu,
});

<object class="GtkMenuButton" id="primary-menu-button">
  <property name="icon-name">open-menu-symbolic</property>
  <property name="menu-model">primary_menu_model</property>
</object>

组件的常用方法¶

默认情况下，GtkMenuButton 将仅显示一个向下箭头图标；您可以使用 set_label() 和 set_icon_name() 分别指定标签或图标。
如果您想显示更复杂的按钮，可以使用 set_child() 方法和一个自定义小部件。
如果您将标签、图标甚至自定义小部件作为按钮的子项显示，仍然可以使用 set_always_show_arrow() 方法请求 GtkMenuButton 显示一个箭头。
如果菜单按钮应作为窗口的主要菜单按钮，并响应 F10 键盘快捷键，则可以使用 set_primary() 方法。

API 参考¶

在示例中，我们使用了以下类