### 背景介绍 在 PyQt 或 PySide 中，可以通过 `QSS` (Qt Style Sheets) 的方式来设置控件的样式。其中，`background-image` 属性可以用来插入背景图片。然而，默认情况下，`background-image` 并不会自动调整图片大小以适应控件尺寸。为了实现图片等比例填充的效果，需要结合其他属性或者额外逻辑。 --- ### 解决方案 #### 方法一：使用 `border-image` 实现等比例缩放 `border-image` 是一种更灵活的方式，能够实现图片的等比例缩放并适配到控件区域。以下是具体代码示例： ```python from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget class MainWindow(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle("Background Image Example") self.setGeometry(100, 100, 800, 600) widget = QWidget(self) self.setCentralWidget(widget) # 设置样式表，使用 border-image 进行等比例缩放 widget.setStyleSheet(""" QWidget { border-image: url(:/images/images/qss.png) stretch; } """) if __name__ == "__main__": app = QApplication([]) window = MainWindow() window.show() app.exec_() ``` 在此方法中，`stretch` 参数会确保图像按比例拉伸至填满整个控件区域[^3]。 --- #### 方法二：动态计算图片尺寸并通过 Python 控制 如果希望更加精确控制图片的比例和位置，则可以在 Python 中动态加载图片，并通过重新绘制事件处理图片显示效果。这种方式虽然复杂一些，但提供了更高的灵活性。 以下是一个简单的例子： ```python from PyQt5.QtCore import Qt, QRectF from PyQt5.QtGui import QPixmap, QPainter from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget class BackgroundWidget(QWidget): def __init__(self, image_path, parent=None): super().__init__(parent) self.image_path = image_path self.pixmap = QPixmap(image_path).scaled( self.size(), aspectRatioMode=Qt.KeepAspectRatio, transformMode=Qt.SmoothTransformation ) def resizeEvent(self, event): self.pixmap = QPixmap(self.image_path).scaled( self.size(), aspectRatioMode=Qt.KeepAspectRatio, transformMode=Qt.SmoothTransformation ) super().resizeEvent(event) def paintEvent(self, event): painter = QPainter(self) rect = QRectF(self.rect()) pixmap_size = self.pixmap.size() scaled_pixmap = self.pixmap.scaled(rect.size().toSize(), Qt.KeepAspectRatio, Qt.SmoothTransformation) target_rect = QRectF((rect.width() - scaled_pixmap.width()) / 2, (rect.height() - scaled_pixmap.height()) / 2, scaled_pixmap.width(), scaled_pixmap.height()) painter.drawPixmap(target_rect.toRect(), scaled_pixmap) class MainWindow(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle("Dynamic Background Image Example") self.setGeometry(100, 100, 800, 600) widget = BackgroundWidget(":/images/images/qss.png", self) self.setCentralWidget(widget) if __name__ == "__main__": app = QApplication([]) window = MainWindow() window.show() app.exec_() ``` 此方法利用了 `paintEvent` 和 `resizeEvent` 来动态调整图片大小，从而保持其原始宽高比[^4]。 --- ### 总结 两种方法各有优劣： - **方法一** 更加简洁易用，适合大多数场景下的快速开发需求。 - **方法二** 提供更高自由度，适用于复杂的自定义绘图需求。 无论哪种方式，都可以满足图片等比例填充的要求。 ---