Use menus to group related commands when the user chooses an action from a compact list. A MenuBar is a horizontal strip of top-level entries. Choosing an entry opens its associated Menu. A Menu is a transient popup containing a vertical list of command items and submenu items.
MenuItem represents a command that the user can choose. It shows text, an optional icon, and an optional separator before the item. MenuSubItem and MenuMenuItem represent entries that open a nested Menu. A MenuBarItem is a top-level submenu entry for a MenuBar.
Applications create menu items and nested menus, add the items to a Menu or MenuBar, and keep them alive until they are removed or disassociated. MenuSubItem and MenuMenuItem associate a nested Menu without taking ownership. Activating a command item emits its MenuItemBase::triggered() signal. Popup provides the transient window behavior used by Menu and can also present other short interactions.
Menu containers and items use the application style for their default appearance. Menu, MenuBar, and MenuItemBase provide local brush, pen, color, and font overrides when an application needs a specific appearance.
Classes | |
| class | Menu |
| Represents a popup menu containing commands and nested menus. More... | |
| class | MenuBar |
| Represents a horizontal bar of top-level menus. More... | |
| class | MenuBarItem |
| Represents a top-level entry in a menu bar. More... | |
| class | MenuBase |
| Defines the coordination interface shared by menu containers. More... | |
| class | MenuItem |
| Represents a command that can be chosen from a menu. More... | |
| class | MenuItemBase |
| Represents the common content and activation behavior of a menu item. More... | |
| class | MenuMenuItem |
| Represents an alternate menu item that manages a nested menu. More... | |
| class | MenuSubItem |
| Represents a menu item that opens a nested menu. More... | |
| class | Popup |
| Represents a borderless transient window. More... | |