Python PyQt6教程三-菜单与工具栏

这是PyQt6教程。本教程适合初学者和中级程序员。阅读本教程后，您将能够编写非平凡的PyQt6应用程序。

代码示例可在本站下载：教程源代码

目录

• 引言
• 日期和时间
• 第一个工程
• 菜单与工具栏
• 布局管理
• 事件和信号
• 对话框
• 小部件
• 小工具II
• 拖放
• 绘画

PyQt6中的菜单和工具栏

在PyQt6教程的这一部分中，我们创建了一个状态栏、菜单栏和工具栏。菜单是位于菜单栏中的一组命令。工具栏上有一些按钮，其中包含应用程序中的一些常用命令。状态栏显示状态信息，通常在应用程序窗口的底部。

PyQt6 QMainWindow

QMainWindow类提供了一个主应用程序窗口。这使得可以创建一个具有状态栏、工具栏和菜单栏的经典应用程序骨架。

PyQt6状态栏

状态栏是一个用于显示状态信息的小部件。

#!/usr/bin/python

"""
ZetCode PyQt6 tutorial

This program creates a statusbar.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt6.QtWidgets import QMainWindow, QApplication


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        self.statusBar().showMessage('Ready')

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('Statusbar')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

状态栏是在QMainWindow小部件的帮助下创建的。

self.statusBar().showMessage('Ready')

为了获取statusbar，我们调用QMainWindow类的statusbar方法。该方法的第一次调用会创建一个状态栏。后续调用返回statusbar对象。showMessage在状态栏上显示一条消息。

PyQt6简单菜单

菜单栏是GUI应用程序的常见部分。它是位于各种菜单中的一组命令。（Mac OS对菜单栏的处理方式不同。为了获得类似的结果，我们可以添加以下行: menubar.setNativeMenuBar(False).)

#!/usr/bin/python

"""
ZetCode PyQt6 tutorial

This program creates a menubar. The
menubar has one menu with an exit action.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt6.QtWidgets import QMainWindow, QApplication
from PyQt6.QtGui import QIcon, QAction


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        exitAct = QAction(QIcon('exit.png'), '&Exit', self)
        exitAct.setShortcut('Ctrl+Q')
        exitAct.setStatusTip('Exit application')
        exitAct.triggered.connect(QApplication.instance().quit)

        self.statusBar()

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(exitAct)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('Simple menu')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

在上面的示例中，我们创建了一个包含一个菜单的菜单栏。此菜单包含一个操作，如果选中，则终止应用程序。还创建了一个状态栏。该操作可通过Ctrl+Q快捷键访问。

exitAct = QAction(QIcon('exit.png'), '&Exit', self)
exitAct.setShortcut('Ctrl+Q')
exitAct.setStatusTip('Exit application')

QAction是对使用菜单栏、工具栏或自定义键盘快捷键执行的操作的抽象。在上述三行中，我们创建了一个带有特定图标和"退出"标签的操作。此外，还为此操作定义了快捷方式。第三行创建了一个状态提示，当我们将鼠标指针悬停在菜单项上时，该提示会显示在状态栏中。

exitAct.triggered.connect(QApplication.instance().quit)

当我们选择这个特定动作时，会发出一个触发信号。该信号连接到QApplicationwidget的退出方法。这将终止应用程序。

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

menuBar方法创建一个菜单栏。我们使用addMenu创建一个文件菜单，并使用addAction添加操作。

PyQt6 子菜单

子菜单是位于另一个菜单内的菜单。

#!/usr/bin/python

"""
ZetCode PyQt6 tutorial

This program creates a submenu.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt6.QtWidgets import QMainWindow, QMenu, QApplication
from PyQt6.QtGui import QAction


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('File')

        impMenu = QMenu('Import', self)
        impAct = QAction('Import mail', self)
        impMenu.addAction(impAct)

        newAct = QAction('New', self)

        fileMenu.addAction(newAct)
        fileMenu.addMenu(impMenu)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('Submenu')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

在这个例子中，我们有两个菜单项；一个位于"文件"菜单中，另一个位于文件的"导入"子菜单中。

impMenu = QMenu('Import', self)

使用QMenu创建新菜单。

impAct = QAction('Import mail', self)
impMenu.addAction(impAct)

使用addAction将操作添加到子菜单中

PyQt6 检查菜单

在下面的示例中，我们创建了一个可以选中和取消选中的菜单。

#!/usr/bin/python

"""
ZetCode PyQt6 tutorial

This program creates a checkable menu.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt6.QtWidgets import QMainWindow, QApplication
from PyQt6.QtGui import QAction


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        self.statusbar = self.statusBar()
        self.statusbar.showMessage('Ready')

        menubar = self.menuBar()
        viewMenu = menubar.addMenu('View')

        viewStatAct = QAction('View statusbar', self, checkable=True)
        viewStatAct.setStatusTip('View statusbar')
        viewStatAct.setChecked(True)
        viewStatAct.triggered.connect(self.toggleMenu)

        viewMenu.addAction(viewStatAct)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('Check menu')
        self.show()


    def toggleMenu(self, state):

        if state:
            self.statusbar.show()
        else:
            self.statusbar.hide()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

该代码示例通过一个操作创建了一个"视图"菜单。该动作显示或隐藏状态栏。当状态栏可见时，菜单项被选中。

viewStatAct = QAction('View statusbar', self, checkable=True)

使用checkable选项，我们创建了一个checkable菜单。

viewStatAct.setChecked(True)

由于状态栏从一开始就可见，我们使用setChecked方法检查操作。

def toggleMenu(self, state):

    if state:
        self.statusbar.show()
    else:
        self.statusbar.hide()

根据动作的状态，我们显示或隐藏状态栏。

PyQt6 上下文菜单

上下文菜单，也称为弹出菜单，是在特定上下文下显示的命令列表。例如，在Opera网络浏览器中，当我们右键单击网页时，我们会得到一个上下文菜单。在这里，我们可以重新加载页面、返回或查看页面源代码。如果我们右键单击工具栏，我们会得到另一个用于管理工具栏的上下文菜单。

#!/usr/bin/python

"""
ZetCode PyQt6 tutorial

This program creates a context menu.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt6.QtWidgets import QMainWindow, QMenu, QApplication


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('Context menu')
        self.show()


    def contextMenuEvent(self, event):

        cmenu = QMenu(self)

        newAct = cmenu.addAction("New")
        openAct = cmenu.addAction("Open")
        quitAct = cmenu.addAction("Quit")
        action = cmenu.exec(self.mapToGlobal(event.pos()))

        if action == quitAct:
            QApplication.instance().quit()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

要使用上下文菜单，我们必须重新实现contextMenuEvent方法。

action = cmenu.exec(self.mapToGlobal(event.pos()))

使用exec方法显示上下文菜单。从事件对象中获取鼠标指针的坐标。mapToGlobal方法将小部件坐标转换为全局屏幕坐标。

if action == quitAct:
    QApplication.instance().quit()

如果从上下文菜单返回的操作等于退出操作，我们将终止应用程序。

PyQt6 工具栏

菜单将我们可以在应用程序中使用的所有命令分组。工具栏提供了对最常用命令的快速访问。

#!/usr/bin/python

"""
ZetCode PyQt6 tutorial

This program creates a toolbar.
The toolbar has one action, which
terminates the application, if triggered.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt6.QtWidgets import QMainWindow,  QApplication
from PyQt6.QtGui import QIcon, QAction


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        exitAct = QAction(QIcon('exit24.png'), 'Exit', self)
        exitAct.setShortcut('Ctrl+Q')
        exitAct.triggered.connect(QApplication.instance().quit)

        self.toolbar = self.addToolBar('Exit')
        self.toolbar.addAction(exitAct)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('Toolbar')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

在上面的示例中，我们创建了一个简单的工具栏。工具栏有一个工具操作，即退出操作，当触发时终止应用程序。

exitAct = QAction(QIcon('exit24.png'), 'Exit', self)
exitAct.setShortcut('Ctrl+Q')
exitAct.triggered.connect(QApplication.instance().quit)

与上面的菜单栏示例类似，我们创建了一个动作对象。该对象有一个标签、图标和一个快捷方式。QA应用程序的退出方法连接到触发信号。

self.toolbar = self.addToolBar('Exit')
self.toolbar.addAction(exitAction)

工具栏是使用addToolBar方法创建的。我们使用addAction向工具栏添加一个动作对象。

PyQt6 主窗口

在本节的最后一个示例中，我们创建了一个菜单栏、工具栏和状态栏。我们还创建了一个中央小部件。

#!/usr/bin/python

"""
ZetCode PyQt6 tutorial

This program creates a skeleton of
a classic GUI application with a menubar,
toolbar, statusbar, and a central widget.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys
from PyQt6.QtWidgets import QMainWindow, QTextEdit, QApplication
from PyQt6.QtGui import QIcon, QAction


class Example(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        textEdit = QTextEdit()
        self.setCentralWidget(textEdit)

        exitAct = QAction(QIcon('exit24.png'), 'Exit', self)
        exitAct.setShortcut('Ctrl+Q')
        exitAct.setStatusTip('Exit application')
        exitAct.triggered.connect(self.close)

        self.statusBar()

        menubar = self.menuBar()
        fileMenu = menubar.addMenu('&File')
        fileMenu.addAction(exitAct)

        toolbar = self.addToolBar('Exit')
        toolbar.addAction(exitAct)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('Main window')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

此代码示例创建了一个具有菜单栏、工具栏和状态栏的经典GUI应用程序的骨架。

textEdit = QTextEdit()
self.setCentralWidget(textEdit)

在这里，我们创建了一个文本编辑小部件。我们将其设置为QMainWindow的中心小部件。中央小部件占据了剩余的所有空间。

在PyQt6教程的这一部分中，我们使用了菜单、工具栏、状态栏和主应用程序窗口。