如何在QSplitter新增控件时优先收缩首个大控件而非小控件

核心问题说明 #

你遇到的是QSplitter默认分配逻辑的特性：新增子控件时会默认对所有现有控件等比例压缩，哪怕splitter总可用空间大于所有子控件sizeHint()之和，也会出现小控件被过度压缩的情况。

实际案例：两个首选高度均为200px的控件在splitter中正常显示：

新增第三个同首选高度的控件后，原有控件被压缩，此时三个控件总首选高度600px小于splitter可用高度，完全可以同时满足所有控件的首选尺寸要求：

可行方案 #

可以调整该默认行为，推荐通过重写QSplitter子类+自定义尺寸分配逻辑实现，无需固定子控件尺寸，完全保留用户自由拖拽调整的能力。

实现思路 #

1. 无需依赖setFixedHeight()这类固定尺寸API，仅在子控件新增/移除、splitter本身尺寸变化时，自动调用setSizes()做初始化分配，不影响后续用户手动拖拽操作。
2. 事件检测逻辑：
   • 重写childEvent()捕获子控件新增、移除事件
   • 重写resizeEvent()捕获splitter本身尺寸变化事件（可选，按需开启）
3. 自定义尺寸分配规则：
   • 先计算所有子控件sizeHint的总尺寸，减去splitter手柄占用的空间，得到实际可用空间
   • 若可用空间 >= 所有子控件sizeHint之和：小控件按sizeHint分配，剩余所有空间分配给指定的主控件
   • 若可用空间不足：按默认逻辑等比例压缩即可

代码示例 #

#include <QSplitter>
#include <QChildEvent>
#include <QResizeEvent>

class AutoAdjustSplitter : public QSplitter
{
    Q_OBJECT
public:
    explicit AutoAdjustSplitter(Qt::Orientation orientation, QWidget *parent = nullptr)
        : QSplitter(orientation, parent)
    {
        // 可选：禁止子控件被拖拽到完全隐藏，不需要可删除
        setChildrenCollapsible(false);
    }

    // 指定优先分配剩余空间的主控件（即你提到的首个大尺寸控件）
    void setMainWidget(QWidget *widget) {
        m_mainWidget = widget;
        adjustWidgetSizes();
    }

protected:
    // 捕获子控件新增、移除事件
    void childEvent(QChildEvent *event) override {
        QSplitter::childEvent(event);
        if (event->added() || event->removed()) {
            adjustWidgetSizes();
        }
    }

    // 捕获splitter自身尺寸变化事件，不需要自动适配窗口大小可删除该函数
    void resizeEvent(QResizeEvent *event) override {
        QSplitter::resizeEvent(event);
        adjustWidgetSizes();
    }

private:
    void adjustWidgetSizes() {
        QList<int> sizeList;
        int totalHintSize = 0;
        bool isHorizontal = (orientation() == Qt::Horizontal);

        // 统计所有子控件的首选尺寸总和
        const QWidgetList allWidgets = widgets();
        for (auto *w : allWidgets) {
            int hint = isHorizontal ? w->sizeHint().width() : w->sizeHint().height();
            totalHintSize += hint;
            sizeList.append(hint);
        }

        // 计算splitter实际可用空间（减去手柄占用的宽度）
        int availableSize = isHorizontal ? width() : height();
        availableSize -= handleWidth() * (allWidgets.count() - 1);

        // 可用空间充足时，剩余空间全部分配给主控件
        if (availableSize > totalHintSize && m_mainWidget && allWidgets.contains(m_mainWidget)) {
            int mainIndex = allWidgets.indexOf(m_mainWidget);
            sizeList[mainIndex] += (availableSize - totalHintSize);
        }

        setSizes(sizeList);
    }

    QWidget *m_mainWidget = nullptr;
};

用法说明 #

实例化AutoAdjustSplitter后，调用setMainWidget()传入你的大尺寸控件即可，后续新增、删除子控件时都会自动按规则分配尺寸，用户后续手动拖拽调整大小不受任何影响。

轻量替代方案 #

如果不需要复杂的自定义逻辑，也可以通过设置控件拉伸因子实现：

• 主控件的尺寸策略拉伸因子设为1
• 其他小控件的拉伸因子设为0
  示例代码：

// 主控件设置
mainWidget->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
mainWidget->setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Preferred, 1, 1);
// 小控件设置
smallWidget->setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Preferred, 0, 0);

该方案无需重写QSplitter，但压缩优先级的灵活度低于自定义子类方案。

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