PopoverMenuBar

GtkPopoverMenuBar presents a horizontal bar of items that pop up popover menus when clicked.

The only way to create instances of GtkPopoverMenuBar is from a GMenuModel.

CSS nodes

menubar
├── item[.active]
┊   ╰── popover
╰── item
    ╰── popover

GtkPopoverMenuBar has a single CSS node with name menubar, below which each item has its CSS node, and below that the corresponding popover.

The item whose popover is currently open gets the .active style class.

GtkPopoverMenuBar uses the MENU_BAR role, the menu items use the MENU_ITEM role and the menus use the MENU role.

class PopoverMenuBar

classmethod new_from_model(model: MenuModel | None = None) → Widget

Creates a GtkPopoverMenuBar from a GMenuModel.

class PopoverMenuBar

add_child(child: Widget, id: str) → bool

Adds a custom widget to a generated menubar.

For this to work, the menu model of bar must have an item with a custom attribute that matches id.

Parameters:

get_menu_model() → MenuModel | None: Returns the model from which the contents of bar are taken.

remove_child(child: Widget) → bool

Removes a widget that has previously been added with add_child().

set_menu_model(model: MenuModel | None = None) → None

Sets a menu model from which bar should take its contents.

class PopoverMenuBar

props.menu_model: MenuModel

The GMenuModel from which the menu bar is created.

The model should only contain submenus as toplevel elements.