PyQt6中ImageTile作为根组件时窗口持续扩张问题咨询

问题现象 #

• 单独执行clickable_image.py：图片自适应窗口大小，窗口根据图片尺寸关系在上下或两侧留有空白，运行完全正常。
• 直接将ImageTile作为根组件执行image_tile.py：窗口会持续向一侧无限扩张。
• 将ImageTile嵌套在QMainWindow中作为根组件：行为恢复正常，与单独运行clickable_image.py时一致。

额外观察结果 #

• 不给ImageTile套QMainWindow时，调用setFixedWidth(some_number)可解决扩张问题，但窗口无法再调整大小。
• 使用setMaxWidth(some_number)替代时，窗口会突破限制持续扩张。

环境信息 #

• Kubuntu 20.04
• AMD x86_64架构
• NVIDIA GPU

代码实现 #

clickable_image.py #

import os.path
import warnings
import sys
from PyQt6.QtWidgets import QLabel, QPushButton, QApplication
from PyQt6.QtGui import QPixmap, QIcon
from typing import Union

class ClickableImage(QPushButton):
    img_lbl: QLabel
    pixmap: Union[QPixmap, None]
    fpath: str
    width_div_height: float = 1.0
    count: int = 0

    def __init__(self, file_path: str):
        super().__init__()
        self.pixmap = None
        self.load_image(file_path)

    def resizeEvent(self, event):
        super().resizeEvent(event)
        self.setIconSize(event.size())
       
    def load_image(self, file_path: str):
        self.fpath = file_path
        self.pixmap = QPixmap(file_path)

        try:
            self.width_div_height = self.pixmap.width() / self.pixmap.height()
        except ZeroDivisionError:
            self.width_div_height = 1.0
        self.setIcon(QIcon(self.pixmap))
        self.setIconSize(self.size())
        self.setStyleSheet("border: none;")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    widget = ClickableImage('PATH/TO/SOME/IMAGE')
    widget.show()
    sys.exit(app.exec())

image_tile.py #

import sys
from PyQt6.QtWidgets import QApplication, QLabel, QVBoxLayout, QSizePolicy, QMainWindow
from clickable_image import ClickableImage
import os

class ImageTile(QLabel):
    def __init__(self, path: str):
        super().__init__()

        # self.setMaximumWidth(1000)

        self.file_path = path
        self.file_nane_lbl = QLabel()
        self.file_nane_lbl.setText(os.path.basename(self.file_path))
        self.image = ClickableImage(self.file_path)
        self.image.setSizePolicy(QSizePolicy.Policy.MinimumExpanding, QSizePolicy.Policy.MinimumExpanding)

        self.b_layout = QVBoxLayout()
        self.b_layout.addWidget(self.image)
        self.b_layout.addWidget(self.file_nane_lbl)
        self.setLayout(self.b_layout)

    def resizeEvent(self, event):
        super().resizeEvent(event)

    def heightForWidth(self, a0: int) -> int:
        return self.width()

class CustomMain(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setCentralWidget(ImageTile('PATH/TO/SOME/IMAGE'))

if __name__ == '__main__':
    app = QApplication(sys.argv)
    # widget = ImageTile('PATH/TO/SOME/IMAGE')
    widget = CustomMain()
    widget.show()
    sys.exit(app.exec())

问题根源 #

这个问题的核心是QLabel作为顶级窗口时的尺寸计算逻辑，与QMainWindow的布局约束机制存在本质差异：

1. QLabel作为顶级窗口的缺陷
   QLabel本质是用于显示内容的组件，默认没有内置的顶级窗口尺寸约束逻辑。当你重写heightForWidth方法返回self.width()，强制组件保持1:1宽高比的同时：

• ClickableImage设置了MinimumExpanding尺寸策略，意味着它会尽可能占据所有可用空间。
• Qt的窗口管理系统会根据子组件的尺寸需求不断调整顶级窗口大小，而1:1的宽高比约束加上子组件的扩张需求，形成了无限循环：窗口变宽→触发heightForWidth要求高度等于宽度→高度增加后子组件有更多空间可扩张→再次触发窗口宽度调整，最终导致窗口无限扩张。

2. QMainWindow的约束作用
   QMainWindow是专门设计的顶级窗口容器，它的centralWidget区域有内置的尺寸平衡逻辑：

• QMainWindow会自动限制centralWidget的最大尺寸不超过屏幕可用空间，同时在窗口调整大小时，会平衡子组件的扩张需求和窗口的实际可用空间，切断了无限扩张的循环。
• 它的布局系统会优先考虑窗口的整体尺寸合理性，而非单纯满足子组件的扩张需求，因此嵌套后行为恢复正常。

3. setFixedWidth与setMaxWidth的差异

• setFixedWidth直接固定了窗口宽度，彻底切断了尺寸调整的循环，因此不会出现扩张，但代价是窗口无法再调整大小。
• setMaxWidth失效的原因是：QLabel作为顶级窗口时，子组件的MinimumExpanding尺寸策略优先级高于父组件的最大宽度限制，Qt会优先满足子组件的扩张需求，导致窗口突破限制继续扩张。

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