Qt 缩放QLabel中QPixmap超出布局边界时窗口自动调整、无法缩小如何解决？

问题原因 #

窗口自动放大、无法缩小的核心原因是：

• 默认QLabel的sizeHint返回值和当前显示的QPixmap尺寸完全一致
• 你给QLabel设置的QSizePolicy::Preferred策略会让布局优先按照sizeHint分配控件大小，图片放大后sizeHint变大，布局会自动向上撑开父控件直到窗口整体resize
• 缩小图片时你没有调整布局的尺寸约束，控件的最小尺寸已经被之前的大图片撑大，所以无法缩小

解决方案 #

方案1：图片自适应窗口大小，超出时自动等比缩放（不裁剪、窗口大小固定可自由拖拽） #

需要修改3处代码：

1. 调整QLabel的尺寸策略，禁用默认的尺寸hint绑定

// Content构造函数中修改sizePolicy设置
contentLabel->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
contentLabel->setMinimumSize(1, 1); // 解除最小尺寸限制，允许窗口缩小

2. 修改scaleImage函数，缩放时判断是否超出当前label的可用尺寸，超出则适配label大小

void Content::scaleImage(double factor) {
    m_scaleFactor *= factor;
    // 计算原始缩放后的尺寸
    int rawW = contentPixmap.width()*m_scaleFactor;
    int rawH = contentPixmap.height()*m_scaleFactor;
    // 获取当前label可用的最大尺寸
    int maxW = contentLabel->width();
    int maxH = contentLabel->height();
    // 如果原始缩放尺寸超出label大小，等比缩小到适配label
    if (rawW > maxW || rawH > maxH) {
        double fitFactor = qMin((double)maxW / rawW, (double)maxH / rawH);
        rawW *= fitFactor;
        rawH *= fitFactor;
    }
    QPixmap pm = contentPixmap.scaled(rawW, rawH, Qt::KeepAspectRatio, Qt::FastTransformation);
    contentLabel->setPixmap(pm);
}

3. 给主窗口的顶层布局设置尺寸约束，禁止布局自动适配子控件大小调整窗口

// 主窗口初始化时添加
window()->layout()->setSizeConstraint(QLayout::SetNoConstraint);

方案2：超出部分裁剪，永远不超出QLabel边界 #

如果不需要展示完整放大后的图片，直接裁剪超出部分即可，修改scaleImage函数：

void Content::scaleImage(double factor) {
    m_scaleFactor *= factor;
    int w = contentPixmap.width()*m_scaleFactor;
    int h = contentPixmap.height()*m_scaleFactor;
    QPixmap rawScaled = contentPixmap.scaled(w, h, Qt::KeepAspectRatio, Qt::FastTransformation);
    // 裁剪出和label大小一致的区域，居中裁剪
    QRect cropRect(
        qMax(0, (w - contentLabel->width())/2), 
        qMax(0, (h - contentLabel->height())/2), 
        qMin(w, contentLabel->width()), 
        qMin(h, contentLabel->height())
    );
    QPixmap cropped = rawScaled.copy(cropRect);
    contentLabel->setPixmap(cropped);
}

方案3：保留完整放大图片，用滚动区域查看，不触发窗口resize #

如果需要看完整放大后的图片，又不想窗口变大，把QLabel放到QScrollArea里即可：

// Content构造函数中修改布局部分
QVBoxLayout *c_layout = new QVBoxLayout(this);
QScrollArea *scrollArea = new QScrollArea(this);
scrollArea->setWidget(contentLabel);
scrollArea->setAlignment(Qt::AlignCenter);
scrollArea->setWidgetResizable(false); // 内容不跟随滚动区域缩放

c_layout->addWidget(scrollArea);

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