PyQt5中Text Edit的常用方法和常用信号

1. 简介

QTextEdit是PyQt中用于显示和编辑文本的强大组件之一。它提供了丰富的功能，可以显示普通文本、富文本和HTML文本，并支持各种格式的编辑和交互。

以下是QTextEdit的一些关键特性：

1. 文本显示和编辑：QTextEdit可以用于显示和编辑文本内容。它支持普通文本、富文本和HTML文本的显示，用户可以通过键盘输入或者通过程序动态地修改文本内容。
2. 格式化文本：QTextEdit允许在文本中应用不同的字体、颜色、样式和对齐方式，以创建美观的文本布局。你可以通过设置富文本或HTML格式来实现这些效果。
3. 文本选择和操作：用户可以通过鼠标或键盘选择文本，并执行操作如复制、剪切和粘贴。QTextEdit提供了一组方法来实现这些功能，也可以通过快捷键来操作。
4. 撤销和重做：QTextEdit支持撤销和重做功能，用户可以回退到之前的编辑状态，或者重新执行已经撤销的操作。
5. 搜索和替换：你可以使用QTextEdit提供的方法来搜索指定的文本内容，并进行替换操作。这使得在文本中进行复杂的搜索和替换操作变得简单。
6. 自动换行：QTextEdit支持自动换行功能，当文本内容超出文本编辑区域时，文本会自动换行显示，而不会水平滚动。
7. 定制化：你可以通过设置不同的属性和样式来定制QTextEdit的外观和行为，以满足特定的需求。

1.1. 常用方法：

• setText(text: str): 设置文本内容。

textEdit.setText("Hello, PyQt5!")

• setHtml(html: str): 设置HTML格式的文本内容。

textEdit.setHtml("<h1>Hello, PyQt5!</h1>")

• toPlainText() -> str: 获取纯文本内容。

text = textEdit.toPlainText()

• toHtml() -> str: 获取HTML格式的内容。

html = textEdit.toHtml()

• clear(): 清除文本内容。

textEdit.clear()

• insertPlainText(text: str): 在光标位置插入纯文本。

textEdit.insertPlainText("Inserted Text")

• insertHtml(html: str): 在光标位置插入HTML格式的文本。

textEdit.insertHtml("<b>Inserted</b> Text")

• find(text: str): 在文本中查找指定文本，并将光标移到找到的位置。

textEdit.find("search text")

• selectAll(): 选择所有文本。

textEdit.selectAll()

1.2 常用信号：

• cursorPositionChanged: 当光标位置发生变化时发射。

  textEdit.cursorPositionChanged.connect(handleCursorPositionChanged)
  

• textChanged: 当文本内容发生改变时发射。

  textEdit.textChanged.connect(handleTextChanged)
  

• copyAvailable(available: bool): 当有文本可复制时发射。

  textEdit.copyAvailable.connect(handleCopyAvailable)
  

• redoAvailable(available: bool): 当可以执行重做操作时发射。

  textEdit.redoAvailable.connect(handleRedoAvailable)
  

• undoAvailable(available: bool): 当可以执行撤销操作时发射。

  textEdit.undoAvailable.connect(handleUndoAvailable)
  

2. Text Edit的常用方法使用案例

我们用下面一个例子来演示QTextEdit的常用方法

import sys
from PyQt5.QtWidgets import QApplication, QTextEdit, QVBoxLayout, QWidget, QPushButton

class TextEditExample(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle("Text Edit Example")
        self.resize(400, 300)

        # 创建 QTextEdit 实例
        self.textEdit = QTextEdit(self)

        # 创建按钮用于演示一些常用操作
        self.button1 = QPushButton("Insert Text", self)
        self.button1.clicked.connect(self.insert_text)

        self.button2 = QPushButton("Clear Text", self)
        self.button2.clicked.connect(self.clear_text)

        self.button3 = QPushButton("Copy", self)
        self.button3.clicked.connect(self.copy_text)

        self.button4 = QPushButton("Paste", self)
        self.button4.clicked.connect(self.paste_text)

        # 垂直布局
        layout = QVBoxLayout()
        layout.addWidget(self.textEdit)
        layout.addWidget(self.button1)
        layout.addWidget(self.button2)
        layout.addWidget(self.button3)
        layout.addWidget(self.button4)
        self.setLayout(layout)

    def insert_text(self):
        # 插入文本到光标位置
        self.textEdit.insertPlainText("Hello, PyQt5!\n")

    def clear_text(self):
        # 清除文本内容
        self.textEdit.clear()

    def copy_text(self):
        # 复制选中的文本
        self.textEdit.copy()

    def paste_text(self):
        # 粘贴文本到光标位置
        self.textEdit.paste()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    ex = TextEditExample()
    ex.show()
    sys.exit(app.exec_())

这个例子创建了一个简单的PyQt5应用程序，包含一个QTextEdit实例和几个按钮，演示了常用的一些操作。每个操作都有对应的按钮，并连接了相应的槽函数，实现了以下功能：

1. Insert Text按钮：点击按钮会在文本编辑器中插入文本“Hello, PyQt5!”。
2. Clear Text按钮：点击按钮会清除文本编辑器中的所有内容。
3. Copy按钮：点击按钮会复制文本编辑器中选中的文本。
4. Paste按钮：点击按钮会粘贴剪贴板中的文本到文本编辑器的光标位置。

运行结果如下：

3. Text Edit 的常用信号使用案例

下面是一个使用QTextEdit常用信号的示例，每个信号都连接了相应的槽函数，

import sys
from PyQt5.QtWidgets import QApplication, QTextEdit, QVBoxLayout, QWidget, QLabel

class TextEditExample(QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.setWindowTitle("Text Edit Signals Example")
        self.resize(400, 300)

        # 创建 QTextEdit 实例
        self.textEdit = QTextEdit(self)

        # 创建用于显示信号的标签
        self.label = QLabel(self)
        self.label.setText("No signal emitted yet.")

        # 垂直布局
        layout = QVBoxLayout()
        layout.addWidget(self.textEdit)
        layout.addWidget(self.label)
        self.setLayout(layout)

        # 将信号与槽函数连接
        self.textEdit.cursorPositionChanged.connect(self.on_cursor_position_changed)
        self.textEdit.textChanged.connect(self.on_text_changed)

    def on_cursor_position_changed(self):
        # 光标位置变化时触发此槽函数
        cursor_pos = self.textEdit.textCursor().position()
        self.label.setText(f"Cursor position changed. Current position: {cursor_pos}")

    def on_text_changed(self):
        # 文本内容变化时触发此槽函数
        text = self.textEdit.toPlainText()
        self.label.setText(f"Text changed. New text: {text}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    ex = TextEditExample()
    ex.show()
    sys.exit(app.exec_())

这个示例创建了一个简单的PyQt5应用程序，包含一个QTextEdit实例和一个标签，用于显示信号的信息。连接了两个常用的信号：

1. cursorPositionChanged信号：当文本编辑器中的光标位置发生变化时触发，连接了on_cursor_position_changed槽函数，该槽函数会在标签中显示当前光标位置的信息。
2. textChanged信号：当文本编辑器中的文本内容发生变化时触发，连接了on_text_changed槽函数，该槽函数会在标签中显示新的文本内容。

运行结果如下：