QMenu¶
The QMenu class provides a menu widget for use in menu bars, context menus, and other popup menus. More…
Synopsis¶
Functions¶
def
actionAt(arg__1)def
actionGeometry(arg__1)def
activeAction()def
addAction(arg__1, arg__2, arg__3[, arg__4=0])def
addAction(arg__1, arg__2[, arg__3=0])def
addAction(icon, text)def
addAction(icon, text, receiver, member[, shortcut={}])def
addAction(text)def
addAction(text, receiver, member[, shortcut={}])def
addMenu(icon, title)def
addMenu(menu)def
addMenu(title)def
addSection(icon, text)def
addSection(text)def
addSeparator()def
clear()def
columnCount()def
defaultAction()def
exec()def
exec(pos[, at=None])def
exec_()def
exec_(arg__1, arg__2[, at=None[, parent=None]])def
exec_(arg__1[, action=None])def
hideTearOffMenu()def
icon()def
insertMenu(before, menu)def
insertSection(before, icon, text)def
insertSection(before, text)def
insertSeparator(before)def
isEmpty()def
isTearOffEnabled()def
isTearOffMenuVisible()def
menuAction()def
popup(pos[, at=None])def
separatorsCollapsible()def
setActiveAction(act)def
setDefaultAction(arg__1)def
setIcon(icon)def
setSeparatorsCollapsible(collapse)def
setTearOffEnabled(arg__1)def
setTitle(title)def
setToolTipsVisible(visible)def
showTearOffMenu()def
showTearOffMenu(pos)def
title()def
toolTipsVisible()
Virtual functions¶
def
initStyleOption(option, action)
Signals¶
def
aboutToHide()def
aboutToShow()def
hovered(action)def
triggered(action)
Static functions¶
def
exec(actions, pos[, at=None[, parent=None]])
Detailed Description¶
A menu widget is a selection menu. It can be either a pull-down menu in a menu bar or a standalone context menu. Pull-down menus are shown by the menu bar when the user clicks on the respective item or presses the specified shortcut key. Use addMenu() to insert a menu into a menu bar. Context menus are usually invoked by some special keyboard key or by right-clicking. They can be executed either asynchronously with popup() or synchronously with exec() . Menus can also be invoked in response to button presses; these are just like context menus except for how they are invoked.
Actions¶
A menu consists of a list of action items. Actions are added with the addAction() , addActions() and insertAction() functions. An action is represented vertically and rendered by QStyle . In addition, actions can have a text label, an optional icon drawn on the very left side, and shortcut key sequence such as “Ctrl+X”.
The existing actions held by a menu can be found with actions() .
There are four kinds of action items: separators, actions that show a submenu, widgets, and actions that perform an action. Separators are inserted with addSeparator() , submenus with addMenu() , and all other items are considered action items.
When inserting action items you usually specify a receiver and a slot. The receiver will be notified whenever the item is triggered() . In addition, QMenu provides two signals, triggered() and hovered() , which signal the QAction that was triggered from the menu.
You clear a menu with clear() and remove individual action items with removeAction() .
A QMenu can also provide a tear-off menu. A tear-off menu is a top-level window that contains a copy of the menu. This makes it possible for the user to “tear off” frequently used menus and position them in a convenient place on the screen. If you want this functionality for a particular menu, insert a tear-off handle with setTearOffEnabled() . When using tear-off menus, bear in mind that the concept isn’t typically used on Microsoft Windows so some users may not be familiar with it. Consider using a QToolBar instead.
Widgets can be inserted into menus with the QWidgetAction class. Instances of this class are used to hold widgets, and are inserted into menus with the addAction() overload that takes a QAction . If the QWidgetAction fires the triggered() signal, the menu will close.
Warning
To make QMenu visible on the screen, exec() or popup() should be used instead of show() or setVisible() . To hide or disable the menu in the menubar, or in another menu to which it was added as a submenu, use the respective properties of menuAction() instead.
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.