PyQt5添加布局后背景图片无法完整显示求助

问题根源 #

你遇到的问题主要有两个原因：

1. 布局覆盖未管理的控件：你直接将背景图的QLabel作为窗口的子控件，但随后给窗口设置了VBoxLayout。在Qt中，当窗口被设置布局后，布局会占据整个窗口的客户区域，那些没被加入布局的子控件会被布局层覆盖或挤压到角落，只能显示很小的一部分。
2. QLabel未设置图片缩放：即使QLabel能正常显示，默认情况下它不会自动缩放图片来匹配自身或窗口的大小，只会按图片原始尺寸显示，超出窗口的部分会被裁剪。

两种解决方法 #

方法一：将背景图QLabel加入布局管理

修改代码，把背景图控件加入布局，并设置它自动缩放图片：

import sys
from PyQt5 import QtWidgets, QtGui


def Window():
    app = QtWidgets.QApplication(sys.argv)
    window = QtWidgets.QWidget()

    window.setWindowTitle("GORKIDEV Application")
    window.setWindowIcon(QtGui.QIcon("telefon.png"))
    window.setGeometry(700, 300, 488, 499)

    background_picture = QtWidgets.QLabel()
    # 开启图片自动缩放，适配QLabel大小
    background_picture.setScaledContents(True)
    background_picture.setPixmap(QtGui.QPixmap("telefon.png"))

    okay = QtWidgets.QPushButton("Okay")
    cancel = QtWidgets.QPushButton("Cancel")

    h_box = QtWidgets.QHBoxLayout()
    h_box.addStretch()
    h_box.addWidget(okay)
    h_box.addWidget(cancel)

    v_box = QtWidgets.QVBoxLayout(window)
    # 将背景图控件加入布局，让它占满窗口剩余空间
    v_box.addWidget(background_picture)
    v_box.addLayout(h_box)

    window.show()
    sys.exit(app.exec_())

Window()

方法二：用QPalette设置窗口背景（更推荐）

这种方式不会和布局冲突，直接将图片设为窗口背景：

import sys
from PyQt5 import QtWidgets, QtGui, QtCore


def Window():
    app = QtWidgets.QApplication(sys.argv)
    window = QtWidgets.QWidget()

    window.setWindowTitle("GORKIDEV Application")
    window.setWindowIcon(QtGui.QIcon("telefon.png"))
    window.setGeometry(700, 300, 488, 499)

    # 使用调色板设置窗口背景图，保持图片比例并平滑缩放
    palette = QtGui.QPalette()
    pixmap = QtGui.QPixmap("telefon.png").scaled(
        window.size(), 
        QtCore.Qt.KeepAspectRatioByExpanding, 
        QtCore.Qt.SmoothTransformation
    )
    palette.setBrush(QtGui.QPalette.Window, QtGui.QBrush(pixmap))
    window.setPalette(palette)

    okay = QtWidgets.QPushButton("Okay")
    cancel = QtWidgets.QPushButton("Cancel")

    h_box = QtWidgets.QHBoxLayout()
    h_box.addStretch()
    h_box.addWidget(okay)
    h_box.addWidget(cancel)

    v_box = QtWidgets.QVBoxLayout(window)
    v_box.addStretch()
    v_box.addLayout(h_box)

    window.show()
    sys.exit(app.exec_())

Window()

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