PyQt5 中的强大工具 ——QTextEdit 富文本框

在 PyQt5 的世界里，QTextEdit 是一个功能强大的富文本框组件，它为开发者提供了丰富的文本编辑和展示功能。本文将深入探讨 PyQt5 中的 QTextEdit，带你领略其强大之处。

一、引言

在现代图形用户界面（GUI）应用程序中，富文本编辑功能是不可或缺的一部分。无论是编写文档、编辑邮件还是创建聊天应用，一个强大的富文本框可以极大地提升用户体验。PyQt5 中的 QTextEdit 正是满足这一需求的利器。

二、QTextEdit 的基本介绍

QTextEdit 是 PyQt5 中的一个类，它继承自 QAbstractScrollArea。这意味着它可以显示大量的文本，并支持滚动条以方便浏览。与普通的文本框（如 QLineEdit）不同，QTextEdit 可以显示富文本，包括不同的字体、颜色、大小、加粗、斜体、下划线等格式。

1. 创建 QTextEdit 对象

在 PyQt5 中，创建一个 QTextEdit 对象非常简单。以下是一个基本的示例：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QTextEdit

class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.text_edit = QTextEdit(self)
        self.setCentralWidget(self.text_edit)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MyWindow()
    window.show()
    sys.exit(app.exec_())

在这个例子中，我们创建了一个名为MyWindow的主窗口类，并在其中创建了一个 QTextEdit 对象。然后，我们将 QTextEdit 设置为主窗口的中央小部件，这样它就会占据主窗口的大部分空间。

2. 设置和获取文本

可以使用setText()方法设置 QTextEdit 的文本内容，使用toPlainText()方法获取纯文本内容，使用toHtml()方法获取富文本内容。例如：

text_edit.setText("Hello, World!")
print(text_edit.toPlainText())

三、QTextEdit 的高级功能

1. 富文本格式设置

QTextEdit 支持丰富的富文本格式设置。可以使用setFontFamily()、setFontPointSize()、setFontWeight()、setFontItalic()、setFontUnderline()等方法设置字体属性。例如：

cursor = self.text_edit.textCursor()
char_format = cursor.charFormat()
char_format.setFontFamily("Arial")
char_format.setFontPointSize(14)
char_format.setFontWeight(QFont.Bold)
char_format.setFontItalic(True)
char_format.setFontUnderline(True)
cursor.setCharFormat(char_format)

在这个例子中，我们首先获取了 QTextEdit 的文本光标，然后获取了光标处的字符格式。接着，我们设置了字体家族、字体大小、字体加粗、字体斜体和字体下划线等属性。最后，我们将修改后的字符格式应用到光标处。

2. 插入图片和链接

QTextEdit 还可以插入图片和链接。可以使用insertImage()方法插入图片，使用insertHtml()方法插入链接。例如：

image_path = "image.jpg"
self.text_edit.insertImage(image_path)
link_text = "Click here"
link_url = "https://www.example.com"
self.text_edit.insertHtml(f'<a href="{link_url}">{link_text}</a>')

在这个例子中，我们首先插入了一张图片，然后插入了一个链接。注意，插入链接时需要使用 HTML 格式。

3. 信号与槽

QTextEdit 提供了一些信号，可以与槽函数连接以实现特定的功能。例如，textChanged信号会在文本内容发生变化时发出。以下是一个示例：

self.text_edit.textChanged.connect(self.on_text_changed)

def on_text_changed(self):
    print("Text changed!")

在这个例子中，我们将 QTextEdit 的textChanged信号与on_text_changed槽函数连接。当文本内容发生变化时，on_text_changed函数将被调用。

四、实际应用案例

1. 简单的文本编辑器

使用 QTextEdit 可以轻松创建一个简单的文本编辑器。以下是一个示例：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QMenuBar, QMenu, QAction, QFileDialog
from PyQt5.QtGui import QIcon

class TextEditor(QMainWindow):
    def __init__(self):
        super().__init__()
        self.text_edit = QTextEdit(self)
        self.setCentralWidget(self.text_edit)
        self.init_menu()

    def init_menu(self):
        menubar = QMenuBar(self)
        file_menu = QMenu("File", self)
        menubar.addMenu(file_menu)
        open_action = QAction(QIcon("open.png"), "Open", self)
        open_action.triggered.connect(self.open_file)
        file_menu.addAction(open_action)
        save_action = QAction(QIcon("save.png"), "Save", self)
        save_action.triggered.connect(self.save_file)
        file_menu.addAction(save_action)

    def open_file(self):
        file_name, _ = QFileDialog.getOpenFileName(self, "Open File", "", "Text Files (*.txt);;All Files (*)")
        if file_name:
            with open(file_name, 'r') as f:
                self.text_edit.setText(f.read())

    def save_file(self):
        file_name, _ = QFileDialog.getSaveFileName(self, "Save File", "", "Text Files (*.txt);;All Files (*)")
        if file_name:
            with open(file_name, 'w') as f:
                f.write(self.text_edit.toPlainText())

if __name__ == '__main__':
    app = QApplication(sys.argv)
    editor = TextEditor()
    editor.show()
    sys.exit(app.exec_())

在这个例子中，我们创建了一个简单的文本编辑器，它具有打开和保存文件的功能。通过菜单中的 “Open” 和 “Save” 选项，用户可以打开和保存文本文件。

2. 聊天应用

QTextEdit 也可以用于创建聊天应用。以下是一个示例：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QTextEdit, QVBoxLayout, QWidget, QPushButton
from PyQt5.QtCore import pyqtSignal, QObject

class ChatWindow(QMainWindow):
    message_sent = pyqtSignal(str)

    def __init__(self):
        super().__init__()
        self.setWindowTitle("Chat Application")
        central_widget = QWidget(self)
        self.setCentralWidget(central_widget)
        layout = QVBoxLayout()
        central_widget.setLayout(layout)
        self.text_edit = QTextEdit()
        layout.addWidget(self.text_edit)
        self.send_button = QPushButton("Send")
        layout.addWidget(self.send_button)
        self.send_button.clicked.connect(self.send_message)
        self.message_sent.connect(self.display_message)

    def send_message(self):
        message = self.text_edit.toPlainText()
        if message:
            self.message_sent.emit(message)
            self.text_edit.clear()

    def display_message(self, message):
        self.text_edit.append(message)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = ChatWindow()
    window.show()
    sys.exit(app.exec_())

在这个例子中，我们创建了一个聊天应用，用户可以在 QTextEdit 中输入消息，然后点击 “Send” 按钮发送消息。发送的消息会显示在 QTextEdit 中。

五、总结

PyQt5 中的 QTextEdit 是一个功能强大的富文本框组件，它提供了丰富的文本编辑和展示功能。通过本文的介绍，你应该对 QTextEdit 的基本用法和高级功能有了更深入的了解。无论是创建简单的文本编辑器还是复杂的聊天应用，QTextEdit 都能发挥重要作用。希望本文对你在 PyQt5 开发中的富文本编辑需求有所帮助。