如何实现QLineEdit子类显示额外灰色文本且保留真实文本？

你的思路方向是对的——重写paintEvent来控制渲染，但直接修改setText会打乱QLineEdit的内部状态，导致光标错位、背景闪烁这些问题，毕竟QLineEdit的paintEvent是为它自身的文本状态设计的。更好的方式是在原文本绘制完成后，额外叠加绘制灰色文本，完全不改动控件的真实文本内容。

下面是具体的实现方案：

核心思路 #

1. 让QLineEdit正常绘制原文本和光标，保持text()的纯净性。
2. 当光标位于文本末尾时，用QPainter在原文本的右侧绘制灰色的额外文本，确保和原文本的排版、样式对齐。

完整代码示例 #

#include <QLineEdit>
#include <QPainter>
#include <QStyleOptionFrame>

class MyLineEdit : public QLineEdit
{
    Q_OBJECT
public:
    explicit MyLineEdit(QWidget *parent = nullptr) : QLineEdit(parent) {}

protected:
    void paintEvent(QPaintEvent *event) override {
        // 第一步：让QLineEdit正常绘制原文本、光标、边框等
        QLineEdit::paintEvent(event);

        // 仅当光标在文本末尾时绘制额外文本
        if (cursorPosition() != text().length()) {
            return;
        }

        // 获取控件的样式信息，用来计算内边距和绘制区域
        QStyleOptionFrame opt;
        initStyleOption(&opt);
        QRect contentRect = style()->subElementRect(QStyle::SE_LineEditContents, &opt, this);

        // 获取字体度量，计算原文本的宽度，确定额外文本的起始位置
        QFontMetrics fm(font());
        int textWidth = fm.horizontalAdvance(text());
        int extraX = contentRect.x() + textWidth;
        int extraY = contentRect.y() + fm.ascent(); // 垂直对齐到文本基线

        // 绘制灰色的额外文本
        QPainter painter(this);
        painter.setPen(palette().color(QPalette::Disabled, QPalette::Text)); // 用禁用态的文本色，更贴近占位符的灰色
        painter.drawText(extraX, extraY, "ThisIsExtraText");
    }
};

关键细节解释 #

• 不修改真实文本：全程没有调用setText()，text()始终返回用户输入的真实内容，完全符合你的需求。
• 样式对齐：通过QStyleOptionFrame获取控件的内边距和内容区域，确保额外文本和原文本在同一行，且符合控件的样式（比如不同主题下的内边距差异）。
• 字体匹配：使用控件自身的fontMetrics计算宽度和垂直位置，保证额外文本和原文本的字体、对齐方式完全一致。
• 颜色选择：用QPalette::Disabled的文本色，既符合灰色的视觉需求，又能自动适配不同的系统主题。

可选优化 #

• 如果需要在控件失去焦点时也显示额外文本，可以把判断条件改成hasFocus() && cursorPosition() == text().length()或者直接去掉hasFocus()的判断，根据你的需求调整。
• 如果额外文本需要换行或者更复杂的格式，可以用QTextLayout来绘制，但对于简单的单行文本，上面的方式足够高效。

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