实战PyQt5: 013-文本编辑控件QTextEdit

QTextEdit简介

QTextEdit是一个用于编辑和显示纯文本和富文本(如HTML文档)的部件，它支持多行文本， 可现实和编辑多行文本内容， QTextEdit可以显示图像，列表和表格。当文本内容超出显示范围的时候，会自动显示水平和(或)垂直滚动条。

QTextEdit中的常用方法：

• setPlainText()： 设置多行普通文本；
• insertPlainText()： 插入普通文本；
• toPlainText()： 返回文本框的文本内容；
• setHtml()： 设置文本框的文本内容为HTML文档；
• insertHtml()： 插入HTML文本内容；
• toHtml()： 返回文本框的HTML内容；
• append()： 追加文本；
• setText()： 设置文本，根据文本内容自动判断是普通文本还是其他富文本；
• clear()： 清除文本框的内容。

QTextEdit中的常用信号：

• textChanged： 文本内容发生改变时，发射该信号；
• selectionChanged： 选中内容发生改变时，发射该信号；
• cursorPositionChanged： 光标位置发生改变时，发射该信号；
• currentCharFormatChanged： 当前字符格式发生改变时，发射该信号；
• copyAvailable： 复制可用时，发射该信号；
• redoAvailable： 重做可用时，发射该信号；
• undoAvailable： 撤销可用时，发射该信号。

注：QTextEdit是一个功能强大的编辑部件，涉及众多和编辑排版相关的函数，比如对齐，字体样式，文档格式，编辑操作等，在这里不做详细介绍了，有兴趣的童鞋可进一步研究。

QTextEdit类继承关系：

 

测试QTextEdit

创建文件qtextedit.py, 实现以下简单的功能

• 点击“显示文本”按钮，显示一段普通文本；
• 点击“显示HTML按钮， 显示HTML文档；
• 点击“显示图像”， 显示一个Python logo。

完整代码如下：

import sys
import os
from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.QtWidgets import (QApplication, QMainWindow, QTextEdit, QPushButton)
 
class DemoTextEdit(QMainWindow):
    def __init__(self, parent=None):
        super(DemoTextEdit, self).__init__(parent)
        
        # 设置窗口标题
        self.setWindowTitle('实战PyQt5: QTextEdit Demo!')      
        # 设置窗口大小
        self.resize(400, 280)
        
        #文本显示编辑
        self.txtEditor = QTextEdit(self)
        self.txtEditor.setGeometry(10, 10, 380, 230)
        
        #按钮
        btn_plain = QPushButton('显示文本', self)
        btn_plain.setGeometry(20, 250, 80, 24)
        btn_plain.clicked.connect(self.buttonPlainClicked)
        btn_html = QPushButton('显示HTML', self)
        btn_html.setGeometry(120, 250, 80, 24)
        btn_html.clicked.connect(self.buttonHtmlClicked)
        btn_image = QPushButton('显示图片', self)
        btn_image.setGeometry(220, 250, 80, 24)
        btn_image.clicked.connect(self.buttonImageClicked)
        
    def buttonPlainClicked(self):
        self.txtEditor.setPlainText('QTextEdit Demo!\nHello PyQt5')
        
    def buttonHtmlClicked(self):
        self.txtEditor.setHtml("QTextEdit Demo!<font color='blue' size='8'><red>Hello PyQt5!</font>")
        
    def buttonImageClicked(self):
        self.txtEditor.setPlainText('QTextEdit Demo!\n')
        path = os.path.dirname(__file__) + '/python-logo.png'
        self.txtEditor.append("<img src='" + path + "'/>")
       
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = DemoTextEdit()
    window.show()
    sys.exit(app.exec()) 

启动运行，可以点击按钮看到显示的图片，也可以窗口内进行基本的编辑操作；测试结果如下图所示：

测试QTextEdit

本文知识点

• QTextEdit显示普通文本；
• QTextEdit显示HTML文本；
• QTextEdit显示图片；
• QTextEdit简单的编辑功能交互操作。

前一篇： 实战PyQt5: 012-工具按钮控件QToolButton