PyQt5主窗口与文本框背景图片无法区分问题排查

故障原因 #

1. 主窗口背景被完全遮挡：QMainWindow的客户区会被CentralWidget完全占据，你通过palette设置的主窗口背景没有展示空间，因为CentralWidget默认铺满整个主窗口可用区域。
2. 全局背景覆盖：CustomWidget的paintEvent会绘制自身整个区域（即整个主窗口客户区），导致无论你引用哪张图，都会覆盖整个界面，所有区域显示同一张背景。

修复方案 #

步骤说明 #

• 重写主窗口的paintEvent，直接在主窗口层面绘制深色羊皮纸背景，绕开central widget的遮挡问题。
• 将central widget设置为透明，让主窗口背景能够透出来。
• 为每个文本框单独创建背景容器，仅在文本框对应的区域绘制浅色背景，实现分层显示。

修改后的完整代码 #

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QTextEdit, QScrollBar, QFrame
from PyQt5.QtGui import QPixmap, QPainter, QBrush, QPalette
from PyQt5.QtCore import Qt

class TextBoxBackground(QWidget):
    """专门用于绘制文本框背景的部件"""
    def __init__(self):
        super().__init__()
        self.background_image = QPixmap("../../Cpp/textbox_bg.png")  # 文本框浅色背景

    def paintEvent(self, event):
        painter = QPainter(self)
        # 绘制与文本框尺寸匹配的背景
        painter.drawPixmap(self.rect(), self.background_image)
        super().paintEvent(event)

class CustomWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Custom Window")
        self.setGeometry(100, 100, 400, 700)

        # 主窗口背景图
        self.main_bg = QPixmap("../../Cpp/parchment_textbox_bg.png")

        # 创建透明的central widget
        central_widget = QWidget()
        central_widget.setAttribute(Qt.WA_TranslucentBackground)
        self.setCentralWidget(central_widget)

        layout = QVBoxLayout(central_widget)
        layout.setSpacing(20)  # 增加文本框之间的间距

        # 逐个创建带背景的文本框组件
        self.add_text_edit_with_background(layout)
        self.add_text_edit_with_background(layout)
        self.add_text_edit_with_background(layout)

    def paintEvent(self, event):
        """重写主窗口paintEvent绘制背景"""
        painter = QPainter(self)
        # 绘制铺满主窗口的背景
        painter.drawPixmap(self.rect(), self.main_bg)
        super().paintEvent(event)

    def add_text_edit_with_background(self, parent_layout):
        """封装创建带背景的文本框的逻辑"""
        # 创建文本框背景容器
        bg_container = QFrame()
        bg_layout = QVBoxLayout(bg_container)
        bg_layout.setContentsMargins(0,0,0,0)  # 去掉内边距

        # 添加文本框背景部件
        text_bg = TextBoxBackground()
        text_bg.setFixedSize(150, 125)  # 与文本框尺寸一致
        bg_layout.addWidget(text_bg)

        # 创建文本框并设置透明
        text_edit = QTextEdit()
        text_edit.setFixedSize(150, 125)
        text_edit.setAttribute(Qt.WA_TranslucentBackground)
        # 将文本框放在背景部件上方
        text_edit.setParent(text_bg)

        # 添加滚动条
        scrollbar = QScrollBar(Qt.Vertical)
        bg_layout.addWidget(scrollbar)
        text_edit.setVerticalScrollBar(scrollbar)

        parent_layout.addWidget(bg_container)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = CustomWindow()
    window.show()
    sys.exit(app.exec_())

关键修改点 #

• 新增TextBoxBackground类，专门负责单个文本框的背景绘制，避免全局覆盖。
• 重写CustomWindow的paintEvent直接绘制主窗口背景，确保背景不会被遮挡。
• 将central widget设置为透明，让主窗口背景能够透显。
• 封装文本框创建逻辑，让每个文本框对应独立的背景容器，实现背景分层。

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