pyqt自定义文本编辑器

创建一个自定义文本编辑器

在现代应用程序中，文本编辑器是常见的组件之一。它们可以被用于编写文档、代码或笔记。今天，我将向大家展示如何使用 PyQt5 创建一个自定义的文本编辑器，支持动态调整字体大小。

1. 项目背景

使用传统的文本编辑器时，用户有时需要快速调整字体大小以提高可读性。通过使用 Ctrl 和 Shift 键的组合，我们可以方便地实现这一功能。下面是我们将实现的完整代码示例。

2. 代码实现

首先，确保安装了 PyQt5，如果还没有安装，可以通过以下命令进行安装：

pip install PyQt5

接下来，我们将创建一个名为 CustomTextEdit 的类，继承自 QTextEdit。这个自定义文本编辑器将在鼠标滚轮上修改字体大小。

2.1 完整代码

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *


class CustomTextEdit(QTextEdit):
    def __init__(self):
        super().__init__()
        self.font_size = 14  # 初始字体大小
        self.max_font_size = 30  # 最大字体大小
        self.min_font_size = 8  # 最小字体大小
        self.canCtrl = True  # 是否可以修改字体大小
        self.setFontPointSize(self.font_size)  # 应用初始字体大小

    def wheelEvent(self, event: QWheelEvent):
        # 获取当前的修饰符
        modifiers = event.modifiers()

        if modifiers == Qt.ControlModifier and self.canCtrl:
            # 仅按下 Control 键，修改显示大小
            delta = event.angleDelta().y()
            new_size = max(
                self.min_font_size,
                min(self.max_font_size, self.currentFont().pointSize() + delta // 120),
            )
            text = self.toPlainText()
            self.clear()
            self.setFontPointSize(new_size)  # 设置新字体大小
            self.setPlainText(text)
        # 检查是否按下 Ctrl 和 Shift 键
        elif (modifiers & (Qt.ControlModifier | Qt.ShiftModifier)) == (Qt.ControlModifier | Qt.ShiftModifier):
            # 同时按下了 Control 和 Shift 修饰符，修改输入文字大小
            delta = event.angleDelta().y()
            if delta > 0:
                self.font_size += 1  # 增加字体大小
            elif delta < 0:
                self.font_size -= 1  # 减小字体大小
                if self.font_size < 1:  # 限制最小字体大小
                    self.font_size = 1
            self.setFontPointSize(self.font_size)  # 更新字体大小
            self.update()  # 刷新控件的显示
        else:
            super().wheelEvent(event)  # 调用基类的事件处理

    def setFontPointSize(self, size):
        font = self.currentFont()
        font.setPointSize(size)  # 设置字体大小
        self.setCurrentFont(font)  # 应用字体
        self.update()  # 刷新控件的显示


if __name__ == "__main__":
    app = QApplication(sys.argv)
    w = CustomTextEdit()  # 创建自定义文本编辑器实例
    w.show()  # 显示窗口
    sys.exit(app.exec_())  # 运行应用程序

2.2 代码分析

• 初始化设置: 在 CustomTextEdit 类的构造函数中，我们初始化了初始字体大小、最大字体大小和最小字体大小。我们还设置了一个 canCtrl 属性，表示是否可以修改字体大小。

• 鼠标滚轮事件 - wheelEvent:

  • 当用户滚动鼠标滚轮时，首先获取当前的修饰符。如果仅按下 Control 键，我们将根据滚轮的方向调整当前字体大小。
  • 如果用户同时按下 Control 和 Shift，我们修改输入文字的字体大小，允许用户快速调整正在输入文本的大小。

• 设置字体大小 - setFontPointSize: 这个方法是核心，它根据传入的大小设置当前文本的字体，并强制更新显示。

3. 运行应用

将上述代码保存为 Python 文件（例如 custom_text_edit.py），然后在终端中运行：

python custom_text_edit.py

运行后，您将看到一个文本编辑器。您可以使用 Ctrl 键调整显示文本的字体大小，使用 Ctrl + Shift 可以调整正在输入的文本大小。

4. 总结

通过实现 CustomTextEdit 类，我们创建了一个功能简单但实用的文本编辑器，可以根据用户的需求动态调整字体大小。这种功能极大地提高了用户体验，尤其是在长时间阅读或编写文档时。

希望这个示例对你有所帮助，如果有任何问题或想法，请在评论区聊聊！