C++ Qt自适应布局实现：随窗口调整排布、支持小窗口滚动

需求匹配的组件选型 #

完全不需要自己编写复杂的宽度计算、列数判断逻辑，两个Qt原生能力就能覆盖全部需求：

• 自适应多列排布：采用Qt官方内置示例提供的QFlowLayout流式布局，它会自动根据容器的可用宽度计算换行时机：宽度不足时保持单列垂直堆叠，宽度足够时自动将后续控件挪到新的一行形成多列排布，完全匹配预期的排布切换效果
• 小尺寸滚动支持：外层套QScrollArea作为承载容器，只要设置正确的大小策略，当内容总尺寸超出窗口可视范围时，会自动生成滚动条支撑全部控件浏览，无需手动处理滚动事件

针对现有代码的改造点 #

• 删除代码中声明了但未实际使用的QHBoxLayout实例，减少无效对象占用
• 替换原固定垂直布局为QFlowLayout，不需要手动计算每列放置的控件数量
• 将承载所有控件的内容实例挂载到QScrollArea内部，开启自动适应内容尺寸的设置，保证滚动范围计算准确
• 原有红色固定尺寸控件的初始化逻辑完全复用，不需要改动

改造后的核心实现代码 #

将Qt官方示例的QFlowLayout组件代码直接引入项目（无第三方依赖，可直接复制到源码中使用），之后MainWindow的实现逻辑如下：

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 初始化滚动区域作为顶层承载
    QScrollArea *scrollArea = new QScrollArea(this);
    // 核心设置：让滚动区域自动根据内容尺寸计算可滚动范围
    scrollArea->setWidgetResizable(true);

    // 初始化内容容器
    QWidget *contentWidget = new QWidget();
    // 初始化流式布局，传入对应边距、控件间距参数，可按需调整
    QFlowLayout *flowLayout = new QFlowLayout(contentWidget, 10, 10, 10);

    int fixedSize = 50;
    for (int i = 0; i < 7; ++i)
    {
        QWidget *itemWidget = new QWidget(contentWidget);
        itemWidget->setStyleSheet("QWidget { background-color: red }");
        itemWidget->setFixedSize(fixedSize, fixedSize);
        // 把控件加入流式布局，排布逻辑完全由布局自动处理
        flowLayout->addWidget(itemWidget);
    }

    scrollArea->setWidget(contentWidget);
    setCentralWidget(scrollArea);
}

实际运行效果 #

• 窗口宽度较窄时，所有控件保持单列垂直向下堆叠，和原基础实现的效果完全一致
• 窗口宽度逐渐拉大时，流式布局会自动将排满当前行的后续控件移动到下一行，自动形成多列排布，直到所有控件在当前宽度下可以全部横向排开
• 窗口尺寸缩小到无法完整展示所有控件时，QScrollArea会自动显示垂直滚动条，可拖动浏览全部控件内容

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