QSplitter 一种布局管理——分割器

Qter

1. Header:        #include <QSplitter>
   
2. qmake:         QT += widgets
   
3. Inherits:        QFrame

复制代码

Properties

childrenCollapsible : bool
handleWidth : int
opaqueResize : bool
orientation : Qt::Orientation

1 childrenCollapsible 子控件是否可以被折叠。

2 handleWidth 分割线宽度。

3 opaqueResize 是否即时改变大小。

• true-默认，当拖动分割线时，控件跟随分割线一起动。
• false-当拖动分割线时，只有分割线动，松开鼠标后，控件才改变大小。
  
  

4 orientation 分割器方向，水平或垂直。 Qt::Horizontal Qt::Vertical

QSplitter分割器分割比例设定
QSplitter *spliter = new QSplitter(Qt::Horizontal,this);
spliter->addWidget(A);
spliter->addWidget(B);
spliter->setStretchFactor(0,3);
spliter->setStretchFactor(1,7);
即可把A、B以3：7的比例分割
setStretchFactor ( int index, int stretch )

QWidget
sizePolicy
结合控件的SizePolicy属性，来控制布局管理中的控件的尺寸自适应方式。
控件的sizePolicy说明控件在布局管理中的缩放方式。Qt提供的控件都有一个合理的缺省sizePolicy，但是这个缺省值有时不能适合所有的布局，开发人员经常需要改变窗体上的某些控件的sizePolicy。一个QSizePolicy的所有变量对水平方向和垂直方向都适用。下面列举了一些最长用的值：
A. Fixed：控件不能放大或者缩小，控件的大小就是它的sizeHint。
B. Minimum：控件的sizeHint为控件的最小尺寸。控件不能小于这个sizeHint，但是可以
放大。
C. Maximum：控件的sizeHint为控件的最大尺寸，控件不能放大，但是可以缩小到它的最小
的允许尺寸。
D. Preferred：控件的sizeHint是它的sizeHint，但是可以放大或者缩小
E. Expandint：控件可以自行增大或者缩小
注：sizeHint（布局管理中的控件默认尺寸，如果控件不在布局管理中就为无效的值）
https://www.cnblogs.com/emouse/archive/2013/05/19/3087708.html

Qter

Splitter [ˈsplɪtə] 分隔条;拆分条;分器;功率分配器;信号分离器
Collapsible  [kəˈlæpsəbl] 可折叠的;可折迭的;可伸缩;可收缩的;可拆卸的
Horizontal [ˌhɒrɪˈzɒntl] 水平的
Vertical [ˈvɜːtɪkl] 垂直的
orientation  [ˌɔːriənˈteɪʃn]  方向
opaque  [əʊˈpeɪk] 不透明的;不透光的;浑浊的;难懂;模糊;隐晦;不清楚
stretch  [stretʃ] 拉长;拽宽;撑大;抻松;有弹性(或弹力);拉紧;拉直;绷紧
Factor [ˈfæktə(r)] 因素;要素;因子;

Hint [hɪnt] 暗示;提示;示意;征兆;迹象;少许;少量
Policy [ˈpɒləsi]  政策;方针;原则
Preferred 较喜欢;喜欢…多于… prefer的过去分词和过去式
Expanding [ɪkˈspændɪŋ] 扩径;展开;扩张;膨胀;扩大

Qter

https://mp.weixin.qq.com/s?__biz=MzU1ODIyOTQ3Mg==&mid=2247483759&idx=1&sn=ac6d56b2abe497e99d87495beda72615&chksm=fc28f3e0cb5f7af601796cd305451d4549d3051d7295a770a416fa332b4cdfc15759c2b278c9&mpshare=1&scene=1&srcid=0204FYnLvez20ju7O9iLYAq2&sharer_sharetime=1580827308259&sharer_shareid=33fb973e60510684b6f44098f762e42c&key=4ee1913bca79c78b17f3785ae2a7de7735459b680518c7e1f5028e9378edc17be991e989abfe78295bac8c48834ac9b472588b0d8b0b64ff0e5174410f1ab7179387c7014c194cd0bb31890522960e00&ascene=1&uin=Mzc3MjM5MzYyOQ%3D%3D&devicetype=Windows+7&version=6208006f&lang=zh_CN&exportkey=A%2FpDN3zZoK6LdRjS%2F6nxqN0%3D&pass_ticket=G8YP2jrw5wj%2F8z3hLH2LoKrOlhW%2BEgSdWWWhFhvDLD3ZisgQnZPqhJzHLu8hOeZ5常用函数

3.3.2.1 saveState()和restoreState()

保存当前状态和恢复之前的状态。当我们使用分割器时，会改变很多控件的大小，当我们想要控件恢复某个状态时就可以使用这两个函数。

当你开发的软件再次打开时，想要恢复到上一次的布局画面，那也可以使用这两个函数，这个功能，我在下面的例子中给大家演示。

3.3.2.2 sizes()和setSizes()

获取和设置分割器中每个控件的宽度或高度。

如果分割器是水平的，那么就会从左到右设置每个控件的宽度。如果分割器是垂直的，那么就会从上到下设置每个控件的高度。

列表中的额外值被忽略。如果列表包含的值太少，则结果是未定义的，但程序仍然会很好。

分割器的总体大小不受影响。相反，根据大小的相对权重（伸缩因子），任何额外/缺失的空间都分布在控件中。

如果指定大小为0，则控件将是不可见的。

控件的大小策略被保留。也就是说，一个小于该控件的最小大小提示的值将被提示的值所取代。

3.3.3 注意事项

3.3.3.1 控件的显隐

当隐藏一个控件的时候，它的空间将被分配给其他的控件。再次展示它时，它会被恢复。

3.3.3.2 布局器与分割器的对比

在QSplitter中是不能直接添加QLayout的，这是因为QSplitter继承自QFrame的，而QLayout继承自QObject和QLayoutItem的，布局是一套算法，QSplitter是窗口控件，所以是不能直接添加的，只有布局才能添加子布局。

因为QSplitter是窗口控件，那它当然就可以使用setLayout()或使QSplitter作为QLayout的父类或使用addWidget()来代替。

3.3.4 示例

新建项目SpliterWidget，类名SpliterWidget，基类为QWidget。

拖入两个QCheckBox，并且都勾选属性checkable，checked

再拖入一个QTextEdit和QPushButton

1. spliterwidget.h
   
2. 
   
3. #ifndef SPLITERWIDGET_H
   
4. #define SPLITERWIDGET_H
   
5. #include <QWidget>
   
6. #include <QSettings>
   
7. 
   
8. namespace Ui {
   
9. class SpliterWidget;
   
10. }
    
11. 
    
12. class SpliterWidget : public QWidget
    
13. {
    
14.     Q_OBJECT
    
15. 
    
16. public:
    
17.     explicit SpliterWidget(QWidget *parent = 0);
    
18.     ~SpliterWidget();
    
19. 
    
20. protected:
    
21.     //重写关闭事件，关于事件我们以后再讲解
    
22.     void closeEvent(QCloseEvent* e);private slots:
    
23.     void on_check_opaqueResize_toggled(bool checked);
    
24.     void on_check_collapsible_toggled(bool checked);
    
25. 
    
26. private:
    
27.     Ui::SpliterWidget *ui;
    
28.     QByteArray state;
    
29.     QSettings settings;
    
30. };
    
31. 
    
32. #endif // SPLITERWIDGET_H
    
33. spliterwidget.cpp
    
34. 
    
35. #include <QDebug>
    
36. #include <QSettings>
    
37. #include "spliterwidget.h"
    
38. #include "ui_spliterwidget.h"
    
39. 
    
40. SpliterWidget::SpliterWidget(QWidget *parent) :
    
41.     QWidget(parent),
    
42.     ui(new Ui::SpliterWidget),
    
43.     settings("MySofts", "SpliterWidget")
    
44. {
    
45.     ui->setupUi(this);
    
46. 
    
47.     //这里用来从注册表中加载分割器上一次关闭前的状态
    
48.     //注册表路径为：HKEY_CURRENT_USER\Software\MySofts\SpliterWidget
    
49.     if (settings.contains("splitterSizes"))
    
50.     {
    
51.         ui->splitter->restoreState(settings.value("splitterSizes").toByteArray());
    
52.         qDebug() << "is restored";
    
53.     }
    
54.     else
    
55.     {
    
56.         qDebug() << "first launch SpliterWidget";
    
57.     }
    
58. }
    
59. 
    
60. SpliterWidget::~SpliterWidget()
    
61. {
    
62.     delete ui;
    
63. }
    
64. 
    
65. void SpliterWidget::closeEvent(QCloseEvent *e)
    
66. {
    
67.     //关闭时保存分割器状态
    
68.     settings.setValue("splitterSizes", ui->splitter->saveState());
    
69.     QWidget::closeEvent(e);
    
70. }
    
71. 
    
72. void SpliterWidget::on_check_opaqueResize_toggled(bool checked)
    
73. {
    
74.     ui->splitter->setOpaqueResize(checked);
    
75. }
    
76. 
    
77. void SpliterWidget::on_check_collapsible_toggled(bool checked)
    
78. {
    
79.     //设置所有控件是否都可以被折叠，如果想设置某个控件，可以使用setCollapsible();
    
80.     ui->splitter->setChildrenCollapsible(checked);
    
81. }

复制代码

编译运行程序，调整分割器的大小，关闭窗口，再次打开程序，程序恢复关闭前分割器的状态。