在Qt中实现图片自适应标签大小

问题描述：

许多人在使用Qt时遇到过这样的问题：将图片显示在一个标签上，但标签的大小被布局指定，而图片加载后会改变标签大小。使用img标签作为文本或CSS背景属性时无法显示完整图片。当调整窗口大小时，图片应自动调整以适应标签的大小，同时保持标签的比例不变。还需要将图片居中显示，如果无法同时适应宽度和高度，希望较小的维度居中显示。

经典的解决方法包括获取标签的大小、调整图片大小以适应标签，处理resize事件。不过，如何在不每次都将整个过程保存到QImage并创建QPixmap的情况下，简单且高效地实现这一功能是本文讨论的重点。

解决方案

本文将介绍几种方法来解决这一问题，包括简单方法和复杂但更灵活的方法。

方法一：使用QLabel::setScaledContents(bool)

这是一个非常简单的方法：

QLabel lblImage;

lblImage.setPixmap(QPixmap("big_image.jpg"));
lblImage.setScaledContents(true);
lblImage.setSizePolicy(QSizePolicy::Ignored, QSizePolicy::Ignored);

通过设置setScaledContents(true)，图像会根据标签大小进行缩放。但需要注意，这种方法不保持图片的宽高比，它会水平或垂直拉伸图片以适应标签。

方法二：保持纵横比并缩放

保持图片宽高比的方法可以通过如下代码实现：

QPixmap originalPixmap = QPixmap("big_image.jpg");

connect(resizeSignal, &QWidget::resize, this, [this, originalPixmap]() {
    ui->label->setPixmap(originalPixmap.scaled(ui->label->size(), Qt::KeepAspectRatio, Qt::SmoothTransformation));
});

在窗口调整大小时，通过QLabel::setPixmap设置缩放后的图片，同时使用Qt::KeepAspectRatio保持图片的宽高比。

方法三：自定义QLabel类

如果需要更高的定制化，可以创建一个继承自QLabel的自定义类，并重载setPixmap和paintEvent方法。

// QPictureLabel.hpp
#include <QImage>
#include <QPixmap>
#include <QLabel>

class QPictureLabel : public QLabel {
    Q_OBJECT

private:
    QPixmap _qpSource;  // 保留原始图像，避免多次调整尺寸质量下降
    QPixmap _qpCurrent;

    void _displayImage();

public:
    explicit QPictureLabel(QWidget *aParent = nullptr) : QLabel(aParent) {}
    void setPixmap(const QPixmap &aPicture);
    void paintEvent(QPaintEvent *aEvent) override;
};

// QPictureLabel.cpp
#include <QPainter>
#include "QPictureLabel.hpp"

void QPictureLabel::paintEvent(QPaintEvent *aEvent) {
    QLabel::paintEvent(aEvent);
    _displayImage();
}

void QPictureLabel::setPixmap(const QPixmap &aPicture) {
    _qpSource = _qpCurrent = aPicture;
    repaint();
}

void QPictureLabel::_displayImage() {
    if (_qpSource.isNull()) // 如果没有图像，不进行绘制
        return;

    float cw = width(), ch = height();
    float pw = _qpCurrent.width(), ph = _qpCurrent.height();

    if ((pw > cw && ph > ch && pw / cw > ph / ch) || 
        (pw > cw && ph <= ch) || 
        (pw < cw && ph < ch && cw / pw < ch / ph)) {
        _qpCurrent = _qpSource.scaledToWidth(cw, Qt::TransformationMode::FastTransformation);
    } else if ((pw > cw && ph > ch && pw / cw <= ph / ch) || 
               (ph > ch && pw <= cw) || 
               (pw < cw && ph < ch && cw / pw > ch / ph)) {
        _qpCurrent = _qpSource.scaledToHeight(ch, Qt::TransformationMode::FastTransformation);
    }

    int x = (cw - _qpCurrent.width()) / 2;
    int y = (ch - _qpCurrent.height()) / 2;

    QPainter paint(this);
    paint.drawPixmap(x, y, _qpCurrent);
}

// 使用示例
QPictureLabel *img_Result = new QPictureLabel(this);
layout->addWidget(img_Result);

QPixmap qpImage("image_path");
img_Result->setPixmap(qpImage);

这个方法通过重载paintEvent来手动绘制图像，并在setPixmap方法中保持原图像的拷贝，避免因为多次缩放导致图像质量下降。

以上几种方法都能实现图片在Qt中自适应标签大小的需求，根据具体需求和实现的复杂度选择适合自己的方法即可。