如何为PyQt5的QTextEdit自定义clicked信号以清除点击时的预置文本

嘿，我看你已经在尝试给QTextEdit加点击信号来清空预置文本了，思路完全没问题，但有几个容易踩的小坑得调整下，咱们一步步搞定它：

你自定义了带clicked信号的QTextEdit子类，但大概率犯了一个常见错误：实例化组件时用了原生的QtWidgets.QTextEdit，而非你自己定义的子类，导致自定义的信号根本没触发。另外，还需要完善清空逻辑，避免误删用户已经输入的内容。

下面是包含所有必要逻辑的代码示例，直接就能跑：

from PyQt5.QtCore import pyqtSignal
from PyQt5 import QtWidgets, QtCore, QtGui
import sys

class ClickableTextEdit(QtWidgets.QTextEdit):
    # 自定义点击信号
    clicked = pyqtSignal()

    def __init__(self, placeholder_text="", parent=None):
        super().__init__(parent)
        # 保存预置文本，用于后续判断是否需要清空
        self.placeholder_text = placeholder_text
        # 初始化时设置预置文本和灰色占位符样式
        self.set_placeholder_style()

    def mouseReleaseEvent(self, event):
        # 触发点击信号
        self.clicked.emit()
        # 必须调用父类的事件处理，否则会破坏组件原有功能（比如选中文本）
        super().mouseReleaseEvent(event)

    def set_placeholder_style(self):
        self.setPlainText(self.placeholder_text)
        # 把预置文本改成灰色，模拟原生输入框的占位符效果
        gray_palette = self.palette()
        gray_palette.setColor(QtGui.QPalette.Text, QtCore.Qt.gray)
        self.setPalette(gray_palette)

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.centralwidget = QtWidgets.QWidget(self)
        self.setCentralWidget(self.centralwidget)
        self.layout = QtWidgets.QVBoxLayout(self.centralwidget)

        # 重点！实例化咱们自定义的子类，不是原生QTextEdit
        self.userfield = ClickableTextEdit(placeholder_text="请输入内容...", parent=self.centralwidget)
        self.userfield.setMaximumSize(QtCore.QSize(400, 100))
        # 连接点击信号到清空槽函数
        self.userfield.clicked.connect(self.clear_placeholder)

        # 可选优化：失去焦点时如果文本为空，恢复预置文本
        self.userfield.focusOutEvent = self.on_focus_lost

        self.layout.addWidget(self.userfield)
        self.setWindowTitle("QTextEdit预置文本清空示例")
        self.resize(500, 200)

    def clear_placeholder(self):
        # 只有当前文本是预置文本时才清空，避免误删用户输入
        if self.userfield.toPlainText() == self.userfield.placeholder_text:
            self.userfield.clear()
            # 恢复正常的黑色文本颜色
            default_palette = self.userfield.palette()
            default_palette.setColor(QtGui.QPalette.Text, QtCore.Qt.black)
            self.userfield.setPalette(default_palette)

    def on_focus_lost(self, event):
        # 失去焦点且文本为空时，恢复预置文本
        if not self.userfield.toPlainText().strip():
            self.userfield.set_placeholder_style()
        # 调用父类的焦点事件处理
        super(type(self.userfield), self.userfield).focusOutEvent(event)

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

• 子类实例化：一定要用你自定义的ClickableTextEdit创建组件，而不是原生的QtWidgets.QTextEdit，否则自定义的clicked信号根本不会触发。
• 事件传递：重写鼠标事件或焦点事件时，必须调用父类的对应方法，不然会破坏组件原有的基础功能（比如无法选中文本、无法正常获取焦点）。
• 防误删逻辑：通过保存预置文本的变量做判断，只有当当前文本和预置文本完全一致时才清空，避免用户输入内容后点击被误删。

如果你只需要点击清空预置文本，不需要失去焦点恢复的功能，可以用更简洁的代码：

from PyQt5.QtCore import pyqtSignal
from PyQt5 import QtWidgets, QtCore
import sys

class ClickableTextEdit(QtWidgets.QTextEdit):
    clicked = pyqtSignal()

    def mouseReleaseEvent(self, event):
        self.clicked.emit()
        super().mouseReleaseEvent(event)

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.centralwidget = QtWidgets.QWidget(self)
        self.setCentralWidget(self.centralwidget)
        self.layout = QtWidgets.QVBoxLayout(self.centralwidget)

        self.userfield = ClickableTextEdit(self.centralwidget)
        self.userfield.setMaximumSize(QtCore.QSize(400, 100))
        # 设置预置文本
        self.userfield.setPlainText("请输入内容...")
        # 用lambda直接绑定清空逻辑
        self.userfield.clicked.connect(lambda: self.userfield.clear() if self.userfield.toPlainText() == "请输入内容..." else None)

        self.layout.addWidget(self.userfield)
        self.setWindowTitle("简化版QTextEdit清空示例")
        self.resize(500, 200)

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

内容的提问来源于stack exchange，提问作者wrong1man