实战PyQt5: 042-了解和运用QAction

QAction简介

在一个典型的GUI程序中，在用户界面上，常常使用不同的操作方式来完成同一个事情，例如在一个应用中创建一个新文件，可以使用菜单条里的"文件"-->"新建"菜单项来完成，也可以点击工具栏上的"新建文件"图标(为一个QToolButton)，或者是使用快捷键来完成这个动作，PyQt提供QAction类来封装用户需要执行的动作，这样不管是菜单栏，抑或是工具条栏，还是快捷键，都可以独立地和和这个动作相关联，这样就很好地做到了界面操作方式和具体行为动作的分离，代码之间的耦合性减少，可维护性良好。一句话，QAction是一个用于菜单栏、工具栏或自定义快捷键的抽象动作行为。

QAction常用方法有：

• setIcon()： 设置图标；
• setText()： 设置要显示的文字；
• setToolTip()： 设置提示文字；
• setShortcut()： 设置快捷键；
• setCheckable()： 设置成check选择模式；
• setChecked()： 设置成选中/未选中(菜单前打勾或不打勾)。

QAction常用信号：

• triggered： 点击时发射信号，( 最常用)；
• hovered： 鼠标悬浮上空时发射该信号；
• toggled： 如果状态为选中，则checked为True，该参数会被发送；
• changed： 只要QAction状态发生改变就会发送，如多了个图标，换了文字等。

QAction类继承关系：

 

测试QAction

在上一篇文章中，在添加一个不带子菜单的菜单项，实践上就是添加了一系列的QAction动作。但是没有对对应的动作添加槽函数，来具体完成这个动作，在本篇中，我们将实现其具体操作。

在notepad.py原来代码的基础上，进行扩充，完成一个基本的文本编辑器，具有新建文件，打开文件，编辑文件，保存文件等基本功能。完整代码如下：

import sys
from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import (QApplication, QMainWindow, QMenuBar, QMenu, 
                             QAction, QPlainTextEdit, QStyle, QFileDialog,
                             QMessageBox)
 
class DemoNotepad(QMainWindow):
    def __init__(self, parent=None):
        super(DemoNotepad, self).__init__(parent)       
        
        # 设置窗口标题
        self.setWindowTitle('实战PyQt5: QAction Demo-记事本')      
        # 设置窗口大小
        self.resize(480, 360)
        
        self.path = None
      
        self.initUi()
        
    def initUi(self):
         #设置一个文本编辑器作为中心小部件
        self.txtEditor = QPlainTextEdit(self)  
        self.setCentralWidget(self.txtEditor)
        
        self.initMenuBar()
       
    def initMenuBar(self):
        menuBar = self.menuBar()       
        fileMenu = menuBar.addMenu('文件(&F)')
        editMenu = menuBar.addMenu('编辑(&E)')
        formatMenu = menuBar.addMenu('格式(&O)')
        helpMenu = menuBar.addMenu('帮助(&H)')
        
        style = QApplication.style()
        
        # ==== 文件操作部分 ==== #
        #新建文件
        aFileNew = QAction('新建(&N)', self)
        #添加一个图标
        aFileNew.setIcon(style.standardIcon(QStyle.SP_FileIcon))
        #添加快捷键
        aFileNew.setShortcut(Qt.CTRL + Qt.Key_N)
        aFileNew.triggered.connect(self.onFileNew)
        fileMenu.addAction(aFileNew)   
        #打开文件
        aFileOpen = QAction('打开(&O)...', self)
        aFileOpen.setIcon(style.standardIcon(QStyle.SP_DialogOpenButton))
        aFileOpen.setShortcut(Qt.CTRL + Qt.Key_O)
        aFileOpen.triggered.connect(self.onFileOpen)
        fileMenu.addAction(aFileOpen)      
        #保存
        aFileSave = QAction('保存(&S)', self) 
        aFileSave.setIcon(style.standardIcon(QStyle.SP_DialogSaveButton)) 
        aFileSave.setShortcut(Qt.CTRL + Qt.Key_S)
        aFileSave.triggered.connect(self.onFileSave)  
        fileMenu.addAction(aFileSave)        
        #另存为
        aFileSaveAs = QAction('另存为(&A)...', self)
        aFileSaveAs.triggered.connect(self.onFileSaveAs)
        fileMenu.addAction(aFileSaveAs)       
        #间隔线
        fileMenu.addSeparator()        
        #退出菜单
        aFileExit = QAction('退出(&X)', self) 
        aFileExit.triggered.connect(self.close)
        fileMenu.addAction(aFileExit)
        
        # ==== 编辑部分 ==== #
        #撤销编辑
        aEditUndo = QAction('撤销(&U)',self)
        aEditUndo.setShortcut(Qt.CTRL + Qt.Key_Z)
        aEditUndo.triggered.connect(self.txtEditor.undo)
        editMenu.addAction(aEditUndo)
        #恢复编辑
        aEditRedo = QAction('恢复(&R)', self)
        aEditRedo.setShortcut(Qt.CTRL + Qt.Key_Y)
        aEditUndo.triggered.connect(self.txtEditor.redo)
        editMenu.addAction(aEditRedo)
        #间隔线
        editMenu.addSeparator()        
        #剪切操作
        aEditCut = QAction('剪切(&T)', self)
        aEditCut.setShortcut(Qt.CTRL + Qt.Key_X)
        aEditCut.triggered.connect(self.txtEditor.cut)
        editMenu.addAction(aEditCut)
        #复制操作
        aEditCopy = QAction('复制(&C)', self)
        aEditCopy.setShortcut(Qt.CTRL + Qt.Key_C)
        aEditCopy.triggered.connect(self.txtEditor.copy)
        editMenu.addAction(aEditCopy)
        #粘贴操作
        aEditPaste = QAction('粘贴(&P)', self)
        aEditPaste.setShortcut(Qt.CTRL + Qt.Key_V)
        aEditPaste.triggered.connect(self.txtEditor.paste)
        editMenu.addAction(aEditPaste)
        #删除操作
        aEditDel = QAction('删除(&L)', self)
        aEditDel.setShortcut(Qt.Key_Delete)
        aEditDel.triggered.connect(self.onEditDelete)
        editMenu.addAction(aEditDel)
        #添加分割线
        editMenu.addSeparator()
        #全选操作
        aEditSelectAll = QAction('全选(&A)', self)
        aEditSelectAll.setShortcut(Qt.CTRL + Qt.Key_A)
        aEditSelectAll.triggered.connect(self.txtEditor.selectAll)
        editMenu.addAction(aEditSelectAll)
        
        # ==== 格式设置部分 ==== #
        aFmtAutoLine = QAction('自动换行(&W)', self)
        aFmtAutoLine.setCheckable(True)
        aFmtAutoLine.setChecked(True)
        aFmtAutoLine.triggered[bool].connect(self.onFormatAutoLine)
        formatMenu.addAction(aFmtAutoLine)
        
        # ==== 帮助部分 ==== #
        aHelpAbout = QAction('关于(&A)...', self)
        aHelpAbout.triggered.connect(self.onHelpAbout)
        helpMenu.addAction(aHelpAbout)
               
    def msgCritical(self, strInfo):
        dlg = QMessageBox(self)
        dlg.setIcon(QMessageBox.Critical)
        dlg.setText(strInfo)
        dlg.show()
        
    def onFileNew(self):
        self.txtEditor.clear()
        
    def onFileOpen(self):
        path,_ = QFileDialog.getOpenFileName(self, '打开文件', '', '文本文件 (*.txt)')
        if path:
            try:
                with open(path, 'rU') as f:
                    text = f.read()
            except Exception as e:
                self.msgCritical(str(e))
            else:
                self.path = path
                self.txtEditor.setPlainText(text)
                
    def onFileSave(self):
        if self.path is None:
            return self.onFileSaveAs()
        self._saveToPath(self.path)
        
    def onFileSaveAs(self):
        path,_ = QFileDialog.getSaveFileName(self, '保存文件', '', '文本文件 (*.txt)')
        if not path:
            return
        self._saveToPath(path)
                
    def _saveToPath(self, path):
        text = self.txtEdit.toPlainText()
        try:
            with open(path, 'w') as f:
                f.write(text)
        except Exception as e:
            self.msgCritical(str(e))
        else:
            self.path = path
            
    def onEditDelete(self):
        tc = self.txtEditor.textCursor()
        #tc.select(QtGui.QTextCursor.BlockUnderCursor) 这样删除一行
        tc.removeSelectedText()
    
    def onFormatAutoLine(self, autoLine):
        if autoLine:
            self.txtEditor.setLineWrapMode(QPlainTextEdit.WidgetWidth)
        else:
            self.txtEditor.setLineWrapMode(QPlainTextEdit.NoWrap)
    
    def onHelpAbout(self):
        QMessageBox.information(self, '实战PyQt5', 'PyQt5实现的文本编辑器演示版')
   
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = DemoNotepad()
    window.show()
    sys.exit(app.exec()) 

运行结果如下图：

测试QAction

本文知识点

• QAction常用函数；
• 打开和保存文件；
• QPlainExitText常用编辑操作；
• QAction设置成check状态。

前一篇： 实战PyQt5: 041-菜单控件QMenu