【PyQt】工具栏(QToolBar)与动作按钮(QAction)使用指南

PyQt工具栏(QToolBar)与动作按钮(QAction)使用指南 🛠️

一、基础用法示例 🌟

class MainWindow(QMainWindow):def __init__(self):super().__init__()# 创建工具栏 🔧self.toolbar = self.addToolBar("主工具栏")# 创建动作集合 🎬self._create_actions()# 设置工具栏图标尺寸 📏self.toolbar.setIconSize(QSize(32, 32))def _create_actions(self):# 新建文件动作 📄self.new_action = QAction(QIcon("icons/new.png"), "新建", self)self.new_action.setShortcut("Ctrl+N")self.new_action.setStatusTip("创建新文件")self.new_action.triggered.connect(self.new_file)self.toolbar.addAction(self.new_action)# 添加分隔符 ➖self.toolbar.addSeparator()# 保存文件动作 💾self.save_action = QAction(QIcon("icons/save.png"), "保存", self)self.save_action.setShortcut("Ctrl+S")self.save_action.triggered.connect(self.save_file)self.toolbar.addAction(self.save_action)

二、完整功能实现 🚀

class AdvancedToolbarDemo(QMainWindow):def __init__(self):super().__init__()self.initUI()def initUI(self):# 创建多个工具栏 🧰self.file_toolbar = self.addToolBar("文件")self.edit_toolbar = self.addToolBar("编辑")# 初始化动作 🎭self.init_actions()# 添加工具栏控件 🎛️self.add_tool_widgets()def init_actions(self):# 打开文件动作 📂self.open_action = QAction(QIcon("icons/open.png"), "打开文件", self)self.open_action.setShortcut("Ctrl+O")self.open_action.triggered.connect(self.open_file)self.file_toolbar.addAction(self.open_action)# 打印动作 🖨️self.print_action = QAction(QIcon("icons/print.png"), "打印", self)self.print_action.setEnabled(False)  # 初始禁用self.print_action.triggered.connect(self.print_document)self.file_toolbar.addAction(self.print_action)# 撤销/重做动作 🔄self.undo_action = QAction(QIcon("icons/undo.png"), "撤销", self)self.undo_action.triggered.connect(self.undo)self.edit_toolbar.addAction(self.undo_action)self.redo_action = QAction(QIcon("icons/redo.png"), "重做", self)self.redo_action.triggered.connect(self.redo)self.edit_toolbar.addAction(self.redo_action)def add_tool_widgets(self):# 添加组合框 🔘self.font_combo = QFontComboBox()self.edit_toolbar.addWidget(self.font_combo)# 添加颜色选择按钮 🎨self.color_btn = QToolButton()self.color_btn.setPopupMode(QToolButton.MenuButtonPopup)color_menu = QMenu(self)color_menu.addAction("红色", lambda: self.set_color(Qt.red))color_menu.addAction("蓝色", lambda: self.set_color(Qt.blue))self.color_btn.setMenu(color_menu)self.color_btn.setIcon(QIcon("icons/color.png"))self.edit_toolbar.addWidget(self.color_btn)# 添加切换按钮 🔘self.grid_toggle = QAction(QIcon("icons/grid.png"), "显示网格", self)self.grid_toggle.setCheckable(True)self.grid_toggle.toggled.connect(self.toggle_grid)self.edit_toolbar.addAction(self.grid_toggle)

三、关键功能说明 🔑

1. 图标设置 🖼️

action.setIcon(QIcon("path/to/icon.png"))

2. 快捷键绑定 ⌨️

action.setShortcut("Ctrl+Shift+S")

3. 状态提示 💡

action.setStatusTip("保存当前文件")

4. 启用/禁用控制 ⚙️

action.setEnabled(False)  # 禁用按钮

5. 可检查状态 ✅

action.setCheckable(True)
action.toggled.connect(handler)

四、高级技巧 🚀

1. 上下文菜单 🖱️

def contextMenuEvent(self, event):menu = QMenu(self)menu.addAction(self.new_action)menu.addAction(self.save_action)menu.exec_(event.globalPos())

2. 工具栏定位 🧭

# 停靠位置设置
self.addToolBar(Qt.LeftToolBarArea, self.file_toolbar)
self.addToolBar(Qt.RightToolBarArea, self.edit_toolbar)# 浮动控制
self.file_toolbar.setFloatable(False)  # 禁止浮动

3. 工具栏样式 🎨

# 设置工具按钮样式
self.toolbar.setToolButtonStyle(Qt.ToolButtonTextUnderIcon)# 自定义样式表
self.toolbar.setStyleSheet("""QToolBar { background: #f0f0f0; }QToolButton { padding: 5px; }
""")

五、注意事项 ⚠️

1. 图标资源 📁
   建议使用Qt资源系统(qrc文件)管理图标，避免路径问题

2. 快捷键冲突 ⚔️
   使用QShortcut类管理全局快捷键

3. 工具栏灵活性 🧩
   允许用户通过setMovable(True)自定义工具栏位置

4. 状态保存 💾
   使用QSettings保存工具栏布局：

settings = QSettings("MyCompany", "MyApp")
settings.setValue("toolbarState", self.saveState())