GtkPopoverMenu 是 GtkPopover 的一个子类，用于实现菜单行为。

GtkPopoverMenu 将其子元素视为菜单并允许在它们之间进行切换。它可以将子菜单作为传统的嵌套子菜单打开，或者以更加触控友好的滑动形式打开。属性 GtkPopoverMenu:flags 控制此外观。

GtkPopoverMenu 主要用于菜单模型，使用 gtk_popover_menu_new_from_model()。如果你需要将其他小部件（例如 GtkSpinButton 或 GtkSwitch）放入弹出窗口中，则可以使用 gtk_popover_menu_add_child()。

要获得更多对话框类似的行为，请使用纯 GtkPopover。

菜单模型

GtkBuilder 为 GMenuModel 理解的 XML 格式由一个顶级 <menu> 元素组成，其中包含一个或多个 <item> 元素。每个 <item> 元素都包含具有强制名称属性的 <attribute> 和 <link> 元素。<link> 元素的内容模型与 <menu> 相同。你可以使用 <submenu> 或 <section> 元素来替代 <link name="submenu"> 或 <link name="section">。

<menu id='app-menu'>
  <section>
    <item>
      <attribute name='label' translatable='yes'>_New Window</attribute>
      <attribute name='action'>app.new</attribute>
    </item>
    <item>
      <attribute name='label' translatable='yes'>_About Sunny</attribute>
      <attribute name='action'>app.about</attribute>
    </item>
    <item>
      <attribute name='label' translatable='yes'>_Quit</attribute>
      <attribute name='action'>app.quit</attribute>
    </item>
  </section>
</menu>

构建菜单项时可以使用属性值，例如其他 GtkBuilder 内容。可以使用 translatable="yes" 属性将 <attribute> 元素标记为可翻译。你还可以使用 context 和 comments 属性指定消息上下文和翻译人员评论。为了使用此功能，必须向 GtkBuilder 提供要使用的 gettext 域。

在构建菜单项时使用以下属性

• “label”：要显示的用户可见字符串
• “use-markup”：菜单项中的文本是否包括 Pango 标记
• “action”：要触发的动作的前缀名称
• “target”：激活动作时要使用的参数
• “icon”和“verb-icon”：可能要显示的图标的名称
• “submenu-action”：跟踪子菜单是否已打开的可能要使用的动作的名称
• “hidden-when”：用于确定何时将项目隐藏的字符串。可能的值包括“action-disabled”、“action-missing”、“macos-menubar”。这主要对导出的菜单有用，请参阅 gtk_application_set_menubar()。
• “custom”：用于匹配 gtk_popover_menu_add_child()、gtk_popover_menu_bar_add_child() 添加的自定义子代，或 UI 文件中的 ID 的字符串 <child type="ID">。

在构建部分时会使用以下属性

• “label”：用作部分标题的用户可见字符串
• “display-hint”：用于确定部分特殊格式的字符串。可能的值包括 “horizontal-buttons”、“circular-buttons” 和 “inline-buttons”。所有这些值都表明应将部分显示为水平按钮行。
• “text-direction”：当 “display-hint” 设置为 “horizontal-buttons” 时，用于确定要使用的 GtkTextDirection 的字符串。可能的值包括 “rtl”、“ltr” 和 “none”。

在构建子菜单时会使用以下属性

• “label”：要显示的用户可见字符串
• “icon”：要显示的图标名称

菜单项还将显示加速器，这些加速器通常通过 gtk_application_set_accels_for_action()、gtk_widget_class_add_binding_action() 或 gtk_shortcut_controller_add_shortcut() 与操作关联。

快捷方式和手势

GtkPopoverMenu 支持以下键盘快捷方式

• 空格 激活默认小部件。

CSS 节点

GtkPopoverMenu 只是添加了自定义内容的 GtkPopover 子类，因此它具有相同的 CSS 节点。这是向主 popover 节点添加 .menu 样式类的情况之一。

菜单项的节点名称为 button，类为 .model。如果设置了区域 display-hint，该区域将获取节点 box，类为 horizontal 外加一个与显示提示内容相同的类。请注意，所述框可能不是项目 button 的直接祖先。因此，例如，若要设置 inline-buttons 区域中的项目样式，请选择 .inline-buttons button.model。在菜单中可能感兴趣的其他样式包括 label 节点。

辅助功能

GtkPopoverMenu 使用 GTK_ACCESSIBLE_ROLE_MENU 角色，其项目根据连接到的操作使用 GTK_ACCESSIBLE_ROLE_MENU_ITEM、GTK_ACCESSIBLE_ROLE_MENU_ITEM_CHECKBOX 或 GTK_ACCESSIBLE_ROLE_MENU_ITEM_RADIO 角色。