PyQt6教程：深入理解菜单栏、工具栏与状态栏的实现

原创于 2025-06-11 09:03:05 发布 · 298 阅读

10 ·

CC 4.0 BY-SA版权

PyQt6教程：深入理解菜单栏、工具栏与状态栏的实现

概述

在GUI应用程序开发中，菜单栏、工具栏和状态栏是三个最基础也是最关键的界面元素。本文将通过PyQt6框架，详细讲解如何创建和使用这些组件，帮助开发者构建专业的桌面应用程序界面。

QMainWindow基础

QMainWindow是PyQt6中用于创建主窗口的核心类，它提供了标准的应用程序框架，包括：

中央部件区域（Central Widget）
菜单栏（Menu Bar）
工具栏（Tool Bar）
状态栏（Status Bar）
停靠部件（Dock Widgets）

from PyQt6.QtWidgets import QMainWindow

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

状态栏实现

状态栏通常位于窗口底部，用于显示临时消息、进度指示器或其他状态信息。

基本实现

def initUI(self):
    # 创建状态栏并显示消息
    self.statusBar().showMessage('应用程序就绪')
    
    # 设置窗口属性
    self.setGeometry(300, 300, 400, 300)
    self.setWindowTitle('状态栏示例')

状态栏进阶用法

状态栏可以显示多种信息：

临时消息（5秒后自动消失）

self.statusBar().showMessage('加载完成', 5000)

永久部件（如进度条）

self.progress = QProgressBar()
self.statusBar().addPermanentWidget(self.progress)

菜单栏开发

菜单栏是应用程序命令的组织中心，通常位于窗口顶部。

基础菜单创建

from PyQt6.QtGui import QAction

def initUI(self):
    # 创建退出动作
    exitAct = QAction('退出', self)
    exitAct.setShortcut('Ctrl+Q')
    exitAct.setStatusTip('退出应用程序')
    exitAct.triggered.connect(self.close)
    
    # 创建菜单栏
    menubar = self.menuBar()
    fileMenu = menubar.addMenu('文件(&F)')  # &表示快捷键Alt+F
    fileMenu.addAction(exitAct)

菜单项类型

PyQt6支持多种菜单项：

普通菜单项

newAct = QAction('新建', self)

可勾选菜单项

viewAct = QAction('显示状态栏', self, checkable=True)
viewAct.setChecked(True)

带图标的菜单项

saveAct = QAction(QIcon('save.png'), '保存', self)

子菜单实现

# 创建导入子菜单
importMenu = QMenu('导入', self)
importMail = QAction('导入邮件', self)
importBookmark = QAction('导入书签', self)

importMenu.addAction(importMail)
importMenu.addAction(importBookmark)

# 添加到文件菜单
fileMenu.addMenu(importMenu)

上下文菜单

上下文菜单（右键菜单）提供了便捷的上下文相关操作。

实现方法

from PyQt6.QtGui import QContextMenuEvent

def contextMenuEvent(self, event):
    contextMenu = QMenu(self)
    
    # 添加菜单项
    cutAct = contextMenu.addAction("剪切")
    copyAct = contextMenu.addAction("复制")
    
    # 显示菜单并获取选择
    action = contextMenu.exec(event.globalPos())
    
    if action == cutAct:
        # 处理剪切操作
        pass

工具栏开发

工具栏提供了常用命令的快速访问方式。

基础工具栏

def initUI(self):
    # 创建工具栏动作
    exitAct = QAction(QIcon('exit.png'), '退出', self)
    exitAct.setShortcut('Ctrl+Q')
    exitAct.triggered.connect(self.close)
    
    # 创建工具栏
    toolbar = self.addToolBar('主工具栏')
    toolbar.addAction(exitAct)

工具栏进阶特性

添加分隔符

toolbar.addSeparator()

设置工具栏位置

self.addToolBar(Qt.ToolBarArea.LeftToolBarArea, toolbar)

可浮动工具栏

toolbar.setFloatable(False)  # 禁止浮动

完整的主窗口示例

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

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()
    
    def initUI(self):
        # 中央部件
        textEdit = QTextEdit()
        self.setCentralWidget(textEdit)
        
        # 状态栏
        self.statusBar().showMessage('就绪')
        
        # 创建退出动作
        exitAct = QAction(QIcon('exit.png'), '退出', self)
        exitAct.setShortcut('Ctrl+Q')
        exitAct.setStatusTip('退出应用')
        exitAct.triggered.connect(self.close)
        
        # 菜单栏
        menubar = self.menuBar()
        fileMenu = menubar.addMenu('文件(&F)')
        fileMenu.addAction(exitAct)
        
        # 工具栏
        toolbar = self.addToolBar('退出')
        toolbar.addAction(exitAct)
        
        # 窗口设置
        self.setGeometry(300, 300, 600, 400)
        self.setWindowTitle('主窗口示例')
        self.show()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = MainWindow()
    sys.exit(app.exec())