类

GtkMenuButton

描述 [src]

final class Gtk.MenuButton : Gtk.Widget
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget {
  /* No available fields */
}

当点击时，GtkMenuButton 小工具用于显示一个弹出式窗口。

该弹出式窗口可作为 GtkPopover 或抽象的 GMenuModel 提供。

GtkMenuButton 小工具可以显示图标（使用 GtkMenuButton:icon-name 属性设置）或标签（使用 GtkMenuButton:label 属性设置）。如果都没有明确设置，则会自动创建一个 GtkImage，使用根据 GtkMenuButton:direction 定向的箭头图像或未设置方向时的常规“open-menu-symbolic”图标。

弹出式窗口的位置由菜单按钮的 GtkMenuButton:direction 属性确定。

对于菜单，菜单的 GtkWidget:halign 和 GtkWidget:valign 属性也已考虑在内。例如，当方向为 GTK_ARROW_DOWN 且水平对齐为 GTK_ALIGN_START 时，菜单会显示在按钮下方，且菜单的起始边缘（取决于文本方向）与按钮的起始边缘对齐。如果在按钮下方没有足够的空间，则菜单会弹出在按钮上方。如果对齐方式会使菜单部分内容移出屏幕之外，则会将菜单“推入”。

	start	center	end
down
up
left
right

CSS 节点

menubutton
╰── button.toggle
    ╰── <content>
         ╰── [arrow]

GtkMenuButton 有一个名称为 menubutton 的单个 CSS 节点，其中包含带有 .toggle 样式类的 button 节点。

如果按钮包含一个图标，它将会有 .image-button 样式类，如果它包含文本，它将会有 .text-button 样式类。除了图标之外，如果箭头、文本或自定义子项也是可见的，它还将带有 .arrow-button 样式类。

在切换按钮内容中，有一个用于指示的 arrow 节点，它将携带 .none、.up、.down、.left 或 .right 样式类之一，以指示菜单将出现在哪个方向。 CSS 预计将为每种情况提供一个合适的图像，使用 -gtk-icon-source 属性。

可以选择，menubutton 节点可以携带 .circular 样式类来请求一个圆形的外观。

无障碍

GtkMenuButton 使用 GTK_ACCESSIBLE_ROLE_BUTTON 角色。

层级

祖先

实现

构造函数

gtk_menu_button_new

创建一个 GtkMenuButton 小组件，具有指向下的箭头，作为唯一的子项。

从 GtkWidget (162) 继承的方法

请参阅 GtkWidget 以了解完整的方法列表。

从 GObject （43）继承的方法

请参阅 GObject 以了解完整的方法列表。

从 GtkBuildable （1）继承的方法

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

从 GtkAccessible 继承的属性 (1)

GtkAccessible:accessible-role

给定 GtkAccessible 实现的可访问角色。

信号

Gtk.MenuButton::activate

在菜单按钮被激活时发出。

自：4.4

从GObject继承来的信号 (1)

GObject::notify

当对象的某个属性通过g_object_set_property()、g_object_set()等方法设置了值时，会在该对象上触发notify信号。

描述 [src]

无障碍

层级

祖先

实现

构造函数

实例方法

从 GtkWidget (162) 继承的方法

从 GObject （43）继承的方法

从 GtkAccessible （19）继承的方法

从 GtkBuildable （1）继承的方法

属性

从 GtkWidget （34）继承的属性

从 GtkAccessible 继承的属性 (1)

信号

从 GtkWidget 继承的信号 (13)

从GObject继承来的信号 (1)