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)
Detailed Description¶
A menu bar consists of a list of pull-down menu items. You add menu items with
addMenu()
. For example, asuming 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¶
-
PySide2.QtWidgets.QMenuBar.
actionAt
(arg__1)¶ - Parameters
arg__1 –
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 –
QAction
- Return type
QRect
Returns the geometry of action
act
as aQRect
.See also
-
PySide2.QtWidgets.QMenuBar.
activeAction
()¶ - Return type
Returns the
QAction
that is currently highlighted. A null pointer will be returned if no action is currently selected.See also
-
PySide2.QtWidgets.QMenuBar.
addAction
(arg__1, arg__2)¶ - Parameters
arg__1 – unicode
arg__2 –
PyObject
-
PySide2.QtWidgets.QMenuBar.
addAction
(text) - Parameters
text – unicode
- 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 – unicode
receiver –
QObject
member – str
- Return type
-
PySide2.QtWidgets.QMenuBar.
addMenu
(icon, title) - Parameters
icon –
QIcon
title – unicode
- 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) -
Appends
menu
to the menu bar. Returns the menu’s menuAction().Note
The returned
QAction
object can be used to hide the corresponding menu.See also
-
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.
initStyleOption
(option, action)¶ - Parameters
option –
QStyleOptionMenuItem
action –
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)¶ -
This convenience function inserts
menu
before actionbefore
and returns the menus menuAction().See also
-
PySide2.QtWidgets.QMenuBar.
insertSeparator
(before)¶ -
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
-
PySide2.QtWidgets.QMenuBar.
isNativeMenuBar
()¶ - Return type
bool
-
PySide2.QtWidgets.QMenuBar.
setActiveAction
(action)¶ - Parameters
action –
QAction
Sets the currently highlighted action to
act
.See also
-
PySide2.QtWidgets.QMenuBar.
setCornerWidget
(w[, corner=Qt.TopRightCorner])¶ - Parameters
w –
QWidget
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
See also
-
PySide2.QtWidgets.QMenuBar.
setNativeMenuBar
(nativeMenuBar)¶ - Parameters
nativeMenuBar –
bool
See also
© 2018 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.