Table of Contents
- QMenuBar
- Synopsis
- Detailed Description
- Usage
- Platform Dependent Look and Feel
- QMenuBar as a Global Menu Bar
- Examples
PySide2.QtWidgets.QMenuBar
PySide2.QtWidgets.QMenuBar.actionAt()
PySide2.QtWidgets.QMenuBar.actionGeometry()
PySide2.QtWidgets.QMenuBar.activeAction()
PySide2.QtWidgets.QMenuBar.addAction()
PySide2.QtWidgets.QMenuBar.addMenu()
PySide2.QtWidgets.QMenuBar.addSeparator()
PySide2.QtWidgets.QMenuBar.clear()
PySide2.QtWidgets.QMenuBar.cornerWidget()
PySide2.QtWidgets.QMenuBar.hovered()
PySide2.QtWidgets.QMenuBar.initStyleOption()
PySide2.QtWidgets.QMenuBar.insertMenu()
PySide2.QtWidgets.QMenuBar.insertSeparator()
PySide2.QtWidgets.QMenuBar.isDefaultUp()
PySide2.QtWidgets.QMenuBar.isNativeMenuBar()
PySide2.QtWidgets.QMenuBar.setActiveAction()
PySide2.QtWidgets.QMenuBar.setCornerWidget()
PySide2.QtWidgets.QMenuBar.setDefaultUp()
PySide2.QtWidgets.QMenuBar.setNativeMenuBar()
PySide2.QtWidgets.QMenuBar.triggered()
Previous topic
Next topic
Quick search
QMenuBar¶
Synopsis¶
Functions¶
def
actionAt
(arg__1)def
actionGeometry
(arg__1)def
activeAction
()def
addAction
(arg__1, arg__2)def
addAction
(text)def
addAction
(text, receiver, member)def
addMenu
(icon, title)def
addMenu
(menu)def
addMenu
(title)def
addSeparator
()def
clear
()def
cornerWidget
([corner=Qt.TopRightCorner])def
initStyleOption
(option, action)def
insertMenu
(before, menu)def
insertSeparator
(before)def
isDefaultUp
()def
isNativeMenuBar
()def
setActiveAction
(action)def
setCornerWidget
(w[, corner=Qt.TopRightCorner])def
setDefaultUp
(arg__1)def
setNativeMenuBar
(nativeMenuBar)
Signals¶
Detailed Description¶
A menu bar consists of a list of pull-down menu items. You add menu items with
addMenu()
. For example, assuming thatmenubar
is a pointer to aQMenuBar
andfileMenu
is a pointer to aQMenu
, the following statement inserts the menu into the menu bar:menubar.addMenu(fileMenu)The ampersand in the menu item’s text sets Alt+F as a shortcut for this menu. (You can use “&&” to get a real ampersand in the menu bar.)
There is no need to lay out a menu bar. It automatically sets its own geometry to the top of the parent widget and changes it appropriately whenever the parent is resized.
Usage¶
In most main window style applications you would use the
menuBar()
function provided inQMainWindow
, addingQMenu
s to the menu bar and addingQAction
s to the pop-up menus.Example (from the Menus example):
fileMenu = menuBar().addMenu(tr("&File")) fileMenu.addAction(Act)Menu items may be removed with
removeAction()
.Widgets can be added to menus by using instances of the
QWidgetAction
class to hold them. These actions can then be inserted into menus in the usual way; see theQMenu
documentation for more details.
Platform Dependent Look and Feel¶
Different platforms have different requirements for the appearance of menu bars and their behavior when the user interacts with them. For example, Windows systems are often configured so that the underlined character mnemonics that indicate keyboard shortcuts for items in the menu bar are only shown when the Alt key is pressed.
QMenuBar as a Global Menu Bar¶
On macOS and on certain Linux desktop environments such as Ubuntu Unity,
QMenuBar
is a wrapper for using the system-wide menu bar. If you have multiple menu bars in one dialog the outermost menu bar (normally inside a widget with widget flagWindow
) will be used for the system-wide menu bar.Qt for macOS also provides a menu bar merging feature to make
QMenuBar
conform more closely to accepted macOS menu bar layout. The merging functionality is based on string matching the title of aQMenu
entry. These strings are translated (usingtr()
) in the “QMenuBar
“ context. If an entry is moved its slots will still fire as if it was in the original place. The table below outlines the strings looked for and where the entry is placed if matched:
String matches
Placement
Notes
about.*
Application Menu | About <application name>
The application name is fetched from the
Info.plist
file (see note below). If this entry is not found no About item will appear in the Application Menu.config, options, setup, settings or preferences
Application Menu | Preferences
If this entry is not found the Settings item will be disabled
quit or exit
Application Menu | Quit <application name>
If this entry is not found a default Quit item will be created to call
quit()
You can override this behavior by using the
menuRole()
property.If you want all windows in a Mac application to share one menu bar, you must create a menu bar that does not have a parent. Create a parent-less menu bar this way:
menuBar = QMenuBar()Note
Do not call
menuBar()
to create the shared menu bar, because that menu bar will have theQMainWindow
as its parent. That menu bar would only be displayed for the parentQMainWindow
.Note
The text used for the application name in the macOS menu bar is obtained from the value set in the
Info.plist
file in the application’s bundle. See Qt for macOS - Deployment for more information.Note
On Linux, if the com.canonical.AppMenu.Registrar service is available on the D-Bus session bus, then Qt will communicate with it to install the application’s menus into the global menu bar, as described.
Examples¶
- class PySide2.QtWidgets.QMenuBar([parent=None])¶
- param parent:
Constructs a menu bar with parent
parent
.
- PySide2.QtWidgets.QMenuBar.actionAt(arg__1)¶
- Parameters:
arg__1 –
PySide2.QtCore.QPoint
- Return type:
Returns the
QAction
atpt
. ReturnsNone
if there is no action atpt
or if the location has a separator.See also
- PySide2.QtWidgets.QMenuBar.actionGeometry(arg__1)¶
- Parameters:
arg__1 –
PySide2.QtWidgets.QAction
- Return type:
Returns the geometry of action
act
as aQRect
.See also
- PySide2.QtWidgets.QMenuBar.activeAction()¶
- Return type:
Returns the
QAction
that is currently highlighted, if any, elseNone
.See also
- PySide2.QtWidgets.QMenuBar.addAction(arg__1, arg__2)¶
- Parameters:
arg__1 – str
arg__2 – object
- PySide2.QtWidgets.QMenuBar.addAction(text)
- Parameters:
text – str
- Return type:
This convenience function creates a new action with
text
. The function adds the newly created action to the menu’s list of actions, and returns it.See also
- PySide2.QtWidgets.QMenuBar.addAction(text, receiver, member)
- Parameters:
text – str
receiver –
PySide2.QtCore.QObject
member – str
- Return type:
- PySide2.QtWidgets.QMenuBar.addMenu(title)¶
- Parameters:
title – str
- Return type:
- PySide2.QtWidgets.QMenuBar.addMenu(icon, title)
- Parameters:
icon –
PySide2.QtGui.QIcon
title – str
- Return type:
Appends a new
QMenu
withicon
andtitle
to the menu bar. The menu bar takes ownership of the menu. Returns the new menu.See also
- PySide2.QtWidgets.QMenuBar.addMenu(menu)
- Parameters:
menu –
PySide2.QtWidgets.QMenu
- Return type:
Appends
menu
to the menu bar. Returns the menu’s menuAction(). The menu bar does not take ownership of the menu.Note
The returned
QAction
object can be used to hide the corresponding menu.See also
- PySide2.QtWidgets.QMenuBar.addSeparator()¶
- Return type:
Appends a separator to the menu.
- PySide2.QtWidgets.QMenuBar.clear()¶
Removes all the actions from the menu bar.
Note
On macOS, menu items that have been merged to the system menu bar are not removed by this function. One way to handle this would be to remove the extra actions yourself. You can set the
menu role
on the different menus, so that you know ahead of time which menu items get merged and which do not. Then decide what to recreate or remove yourself.See also
- PySide2.QtWidgets.QMenuBar.cornerWidget([corner=Qt.TopRightCorner])¶
- Parameters:
corner –
Corner
- Return type:
Returns the widget on the left of the first or on the right of the last menu item, depending on
corner
.Note
Using a corner other than
TopRightCorner
orTopLeftCorner
will result in a warning.See also
- PySide2.QtWidgets.QMenuBar.hovered(action)¶
- Parameters:
action –
PySide2.QtWidgets.QAction
- PySide2.QtWidgets.QMenuBar.initStyleOption(option, action)¶
- Parameters:
action –
PySide2.QtWidgets.QAction
Initialize
option
with the values from the menu bar and information fromaction
. This method is useful for subclasses when they need aQStyleOptionMenuItem
, but don’t want to fill in all the information themselves.See also
- PySide2.QtWidgets.QMenuBar.insertMenu(before, menu)¶
- Parameters:
before –
PySide2.QtWidgets.QAction
menu –
PySide2.QtWidgets.QMenu
- Return type:
This convenience function inserts
menu
before actionbefore
and returns the menus menuAction().See also
- PySide2.QtWidgets.QMenuBar.insertSeparator(before)¶
- Parameters:
before –
PySide2.QtWidgets.QAction
- Return type:
This convenience function creates a new separator action, i.e. an action with
isSeparator()
returning true. The function inserts the newly created action into this menu bar’s list of actions before actionbefore
and returns it.See also
- PySide2.QtWidgets.QMenuBar.isDefaultUp()¶
- Return type:
bool
This property holds the popup orientation.
The default popup orientation. By default, menus pop “down” the screen. By setting the property to true, the menu will pop “up”. You might call this for menus that are below the document to which they refer.
If the menu would not fit on the screen, the other direction is used automatically.
- PySide2.QtWidgets.QMenuBar.isNativeMenuBar()¶
- Return type:
bool
This property holds Whether or not a menubar will be used as a native menubar on platforms that support it.
This property specifies whether or not the menubar should be used as a native menubar on platforms that support it. The currently supported platforms are macOS, and Linux desktops which use the com.canonical.dbusmenu D-Bus interface (such as Ubuntu Unity). If this property is
true
, the menubar is used in the native menubar and is not in the window of its parent; iffalse
the menubar remains in the window. On other platforms, setting this attribute has no effect, and reading this attribute will always returnfalse
.The default is to follow whether the
AA_DontUseNativeMenuBar
attribute is set for the application. Explicitly setting this property overrides the presence (or absence) of the attribute.
- PySide2.QtWidgets.QMenuBar.setActiveAction(action)¶
- Parameters:
action –
PySide2.QtWidgets.QAction
Sets the currently highlighted action to
act
.See also
- PySide2.QtWidgets.QMenuBar.setCornerWidget(w[, corner=Qt.TopRightCorner])¶
- Parameters:
corner –
Corner
This sets the given
widget
to be shown directly on the left of the first menu item, or on the right of the last menu item, depending oncorner
.The menu bar takes ownership of
widget
, reparenting it into the menu bar. However, if thecorner
already contains a widget, this previous widget will no longer be managed and will still be a visible child of the menu bar.Note
Using a corner other than
TopRightCorner
orTopLeftCorner
will result in a warning.See also
- PySide2.QtWidgets.QMenuBar.setDefaultUp(arg__1)¶
- Parameters:
arg__1 – bool
This property holds the popup orientation.
The default popup orientation. By default, menus pop “down” the screen. By setting the property to true, the menu will pop “up”. You might call this for menus that are below the document to which they refer.
If the menu would not fit on the screen, the other direction is used automatically.
- PySide2.QtWidgets.QMenuBar.setNativeMenuBar(nativeMenuBar)¶
- Parameters:
nativeMenuBar – bool
This property holds Whether or not a menubar will be used as a native menubar on platforms that support it.
This property specifies whether or not the menubar should be used as a native menubar on platforms that support it. The currently supported platforms are macOS, and Linux desktops which use the com.canonical.dbusmenu D-Bus interface (such as Ubuntu Unity). If this property is
true
, the menubar is used in the native menubar and is not in the window of its parent; iffalse
the menubar remains in the window. On other platforms, setting this attribute has no effect, and reading this attribute will always returnfalse
.The default is to follow whether the
AA_DontUseNativeMenuBar
attribute is set for the application. Explicitly setting this property overrides the presence (or absence) of the attribute.
- PySide2.QtWidgets.QMenuBar.triggered(action)¶
- Parameters:
action –
PySide2.QtWidgets.QAction
© 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.