QSplitter设置宽高比例的正确方法

问题

实际开发中，需要经常调整QSplitter中子窗口的宽度/高度比例。对水平QSplitter来说，是宽度比例；对垂直QSplitter来说，是高度比例。下面以水平QSplitter为例说明。

我们首先应该会想起看看QSplitter是不是有设置比例的函数。查找文档，发现有一个setStretchFactor函数。经过尝试以后，发现无论如何设置，都不能获得想要的效果。

没有想象的顺利，那么就需要仔细阅读官方文档。下面是官方文档对于此函数的描述：

翻译过来意思是：

此函数用于更新尺寸策略中，对应索引位置窗口的伸缩比例值。

参数stretch不是真正有效的伸缩比例；最终呈现的窗口大小是伸缩因子stretch乘上index对应的子窗口的初始宽度（以水平为例）。

可见，最终的子窗口的宽度或高度，并不是仅仅调用一次setStretchFactor就可以控制最终显示效果的。也就是说，最终显示结果是由stretch factor和子窗口初始宽度以乘积的方式共同决定的。

方案

点击QSplitter函数文档下方的链接的相关函数，可以发现setSizes函数是用来设置子窗口宽度值的。

于是使用以下代码设置并测试：

// 设置比例5:1
QList<int> sizes;

// 在保持比例的情况下，绝对值要尽量大
sizes << 50000 << 10000; 
ui->splitter->setSizes(sizes);

注意上面的代码，我们没有调用setStretchFactor，所以stretchFactor默认为1:1，所以最终比例由setSizes函数来决定。

提出一个小问题：为什么setSizes绝对值要尽量大？此处为答案¹。

总结

以后遇到QSplitter设置比例，直接使用setSizes，且在保持你想要设置的比例的前提下，尽量给setSizes设置比较大的参数。

---

1. 小问题答案：如果给setSizes的参数很小，且如果小于QSplitter，QSplitter内的子窗口将被拉伸，想要保持你想要的比例根本不可能。所以，将setSizes参数设置为万级别大小，是一个比较好的选择。 ↩︎