如何为QPlainTextEdit添加自定义背景图片？

有两种常用的实现方案，可根据需求选择：

方案1：使用QSS（Qt样式表）实现，最简单快捷 #

注意：必须先将QPlainTextEdit的viewport背景设为透明，否则自定义背景图会被控件默认的白色背景遮挡
直接为控件设置如下样式即可：

PyQt/PySide 示例代码 #

from PyQt5.QtWidgets import QApplication, QPlainTextEdit
import sys

if __name__ == "__main__":
    app = QApplication(sys.argv)
    edit = QPlainTextEdit()
    # 替换url内的路径为你的实际图片路径
    edit.setStyleSheet("""
    QPlainTextEdit {
        background-image: url(./custom_bg.png);
        background-position: center;
        background-repeat: no-repeat; /* 可改为stretch实现背景随控件拉伸 */
        background-attachment: fixed;
    }
    QPlainTextEdit QAbstractScrollArea::viewport {
        background: transparent;
    }
    /* 可选：调整文字颜色、选中样式，避免和背景冲突 */
    QPlainTextEdit {
        color: #ffffff;
        selection-background-color: rgba(0, 0, 0, 0.35);
    }
    """)
    edit.resize(600, 400)
    edit.show()
    sys.exit(app.exec_())

C++ Qt 示例代码 #

#include <QApplication>
#include <QPlainTextEdit>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QPlainTextEdit w;
    w.resize(600, 400);
    w.setStyleSheet(R"(
        QPlainTextEdit {
            background-image: url(./custom_bg.png);
            background-position: center;
            background-repeat: no-repeat;
            background-attachment: fixed;
            color: #ffffff;
            selection-background-color: rgba(0, 0, 0, 0.35);
        }
        QPlainTextEdit QAbstractScrollArea::viewport {
            background: transparent;
        }
    )");
    w.show();
    return a.exec();
}

方案2：重写paintEvent实现，适合需要自定义背景绘制逻辑的场景 #

如果需要对背景做动态切换、渐变叠加等更复杂的控制，可以继承QPlainTextEdit重写绘制事件：

from PyQt5.QtWidgets import QPlainTextEdit
from PyQt5.QtGui import QPainter, QPixmap, Qt

class CustomBgTextEdit(QPlainTextEdit):
    def __init__(self, bg_path, parent=None):
        super().__init__(parent)
        self.bg_pixmap = QPixmap(bg_path)
    
    def paintEvent(self, event):
        # 先绘制背景
        QPainter painter(self.viewport())
        # 按控件尺寸缩放背景图，也可自行调整绘制位置、透明度等参数
        scaled_pix = self.bg_pixmap.scaled(self.viewport()->size(), Qt.KeepAspectRatio, Qt.SmoothTransformation)
        painter.drawPixmap(0, 0, scaled_pix)
        # 再调用父类方法绘制文字内容，保证文字在背景上层
        super().paintEvent(event)

通用注意事项 #

• 图片路径要填写正确，如果使用Qt资源系统，路径前缀要加qrc:
• 如果背景图颜色较浅，可调整文字颜色为深色调，避免阅读困难
• 控件滚动时背景默认固定不动，要实现背景跟随滚动的效果，可在paintEvent中根据滚动条位置调整背景图的绘制偏移量

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