PyQt5 教程 - 菜单栏

Jinku Hu 2023年1月30日 2020年3月28日
  1. PyQt5 菜单栏基本示例
  2. PyQt5 菜单栏菜单项图标
  3. PyQt5 菜单栏可选中的菜单项
PyQt5 教程 - 菜单栏

菜单栏通常位于 GUI 的左上角和标题栏下方。如果用户单击菜单上的项目,则可能会执行打开文件,保存文件或退出应用程序之类的操作。

我们将学习如何启动菜单栏,将操作绑定到菜单,添加快捷方式以及显示状态文本。

PyQt5 菜单栏基本示例

与大多数编辑器一样,我们将创建第一个具有 File 菜单的 PyQt5 菜单栏示例。为了简单起见,我们仅包含 Exit 子菜单。

import sys
from PyQt5.QtWidgets import QMainWindow, QAction, qApp, QApplication

class basicMenubar(QMainWindow):
    
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)        
        
        self.initUI()        
        
    def initUI(self):    
        
        self.setGeometry(200, 200, 200, 200)           
        
        exitAction = QAction('&Exit', self)        
        exitAction.setShortcut('Ctrl+Q')
        exitAction.setStatusTip('Exit application')
        exitAction.triggered.connect(qApp.quit)

        self.statusBar()

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(exitAction)
        
        
        self.setWindowTitle('PyQt5 Basic Menubar')    
        self.show()
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = basicMenubar()
    sys.exit(app.exec_())

PyQt5 基本菜单栏

menubar = self.menuBar()

QMainWindow 具有 menuBar() 方法来创建菜单栏。

fileMenu = menubar.addMenu('&File')
fileMenu.addAction(exitAction)

fileMenu 以名称 File 添加到菜单栏,它由与 QAction 对象-exitAction 相关联的菜单项组成。

exitAction = QAction('&Exit', self)        
exitAction.setShortcut('Ctrl+Q')
exitAction.setStatusTip('Exit application')
exitAction.triggered.connect(qApp.quit)

它创建 QAction 对象以退出应用程序,并将该对象保存到变量 exitAction 中。

这个 QAction 对象的名称为&Exit,并与快捷键 CTRL+Q 相关联。

exitAction.setStatusTip('Exit application')

当用户将鼠标指针悬停在此菜单项上时,它将在状态栏 self.statusBar 中显示额外的消息。

exitAction.triggered.connect(qApp.quit)

我们将触发此退出操作的事件连接到应用程序的退出 slot

PyQt5 菜单栏菜单项图标

我们有两种方法可以在 PyQt5 菜单栏中设置菜单项的图标。

PyQt5 默认样式的标准像素图

我们可以使用默认样式的标准像素图将菜单项图标设置为标准图标。

self.style().standardIcon(QStyle.SP_DialogCancelButton)

上面的代码选择对话框取消的标准图标。

PyQt5 菜单栏 Pixmap QStyle 图标

import sys
from PyQt5.QtWidgets import QMainWindow, QAction, qApp, QApplication, QStyle

class basicMenubar(QMainWindow):
    
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs) 
        
        self.initUI()        
        
    def initUI(self):    
        
        self.setGeometry(200, 200, 200, 200)           
        
        exitAction = QAction(self.style().standardIcon(QStyle.SP_DialogCancelButton),
                             '&Exit', self)        
        exitAction.setShortcut('Ctrl+Q')
        exitAction.setStatusTip('Exit application')
        exitAction.triggered.connect(qApp.quit)

        self.statusBar()

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(exitAction)
        
        
        self.setWindowTitle('PyQt5 Basic Menubar')    
        self.show()
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = basicMenubar()
    sys.exit(app.exec_())

将图像文件与 QIcon 一起使用

除了上述使用 QStyle 中默认图标的方法外,我们还可以使用 QIcon 类将任何图像文件用作图标。

QIcon('exit.png')

它将图像文件 exit.png 设置为图标。exit.png 文件应与 Python 脚本文件位于同一文件夹中。

PyQt5 菜单栏 QIcon 图标

import sys
from PyQt5.QtWidgets import QMainWindow, QAction, qApp, QApplication, QStyle
from PyQt5.QtGui import QIcon

class basicMenubar(QMainWindow):
    
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)        
        
        self.initUI()        
        
    def initUI(self):    
        
        self.setGeometry(200, 200, 200, 200)           
        
        exitAction = QAction(QIcon('exit.png'),
                             '&Exit', self)        
        exitAction.setShortcut('Ctrl+Q')
        exitAction.setStatusTip('Exit application')
        exitAction.triggered.connect(qApp.quit)

        self.statusBar()

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(exitAction)
        
        
        self.setWindowTitle('PyQt5 Basic Menubar')    
        self.show()
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = basicMenubar()
    sys.exit(app.exec_())

PyQt5 菜单栏可选中的菜单项

Checkable 菜单项可以选中或取消选中,并且每次用户单击它时都会切换状态。

我们需要在创建 QAction 对象时将关键字参数 checkable 设置为 True,以使菜单项可检查。

import sys
from PyQt5.QtWidgets import QMainWindow, QAction, qApp, QApplication, QLabel
from PyQt5.QtGui import QIcon
from PyQt5.QtCore import Qt

class basicMenubar(QMainWindow):
    
    def __init__(self):
        super().__init__()        
        
        self.initUI()        
        
    def initUI(self):    
        
        self.setGeometry(200, 200, 200, 200)  
        
        self.label = QLabel("The toggle state is ")
        self.label.setAlignment(Qt.AlignCenter)
        
        self.setCentralWidget(self.label)
        
        toggleAction = QAction('&Toggle Label', self, checkable=True)        
        toggleAction.setStatusTip('Toggle the label')
        toggleAction.triggered.connect(self.toggleLabel)
        
        exitAction = QAction(QIcon('exit.png'),
                             '&Exit', self)        
        exitAction.setShortcut('Ctrl+Q')
        exitAction.setStatusTip('Exit application')
        exitAction.triggered.connect(qApp.quit)

        self.statusBar()

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(toggleAction)
        fileMenu.addAction(exitAction)
        
        
        
        self.setWindowTitle('PyQt5 Basic Menubar')    
        self.show()
        
    def toggleLabel(self, state):
        self.label.setText("The toggle state is {}".format(state))
        
        
if __name__ == '__main__':
    
    app = QApplication(sys.argv)
    ex = basicMenubar()
    sys.exit(app.exec_())

PyQt5 菜单栏可选中项

toggleAction = QAction('&Toggle Label', self, checkable=True)  

应该将 checkable 属性设置为 True,以使我们在启动 QAction 对象时可以选中菜单项。

或者我们可以在创建对象后使用 setCheckable() 方法。

self.setCheckable(True)
注意

可选中项的状态是回调函数的参数。因此,在定义函数时,应在参数中列出它。比如,

def toggleLabel(self, state):

状态是布尔类型,选中时为 True,未选中时为 False

Author: Jinku Hu
Jinku Hu avatar Jinku Hu avatar

Founder of DelftStack.com. Jinku has worked in the robotics and automotive industries for over 8 years. He sharpened his coding skills when he needed to do the automatic testing, data collection from remote servers and report creation from the endurance test. He is from an electrical/electronics engineering background but has expanded his interest to embedded electronics, embedded programming and front-/back-end programming.

LinkedIn