一、说明：
    QT主要有一下容器：
    image.png

    二、QWidget容器：
    1、属性设置：
    【QT】1.5-容器 - 图2

    三、Frame容器：
    1、说明：
    QFrame 就是一个升级版的 QWidget, 它继承了 QWidget 的属性，并且做了拓展，这种类型的容器窗口可以提供边框，并且可以设置边框的样式、宽度以及边框的阴影
    3、属性设置：
    【QT】1.5-容器 - 图3
    2、常用API：

    1. /*
    2. 边框形状为布尔类型, 可选项为:
    3.     - QFrame::NoFrame: 没有边框
    4.     - QFrame::Box: 绘制一个框
    5.     - QFrame::Panel: 绘制一个面板，使内容显示为凸起或凹陷
    6.     - QFrame::StyledPanel: 绘制一个外观取决于当前GUI样式的矩形面板。它可以上升也可以下沉。
    7.     - QFrame::HLine: 画一条没有边框的水平线(用作分隔符)
    8.     - QFrame::VLine: 画一条没有边框的垂直线(用作分隔符)
    9.     - QFrame::WinPanel: 绘制一个矩形面板，可以像Windows 2000那样向上或向下移动。
    10.                     指定此形状将线宽设置为2像素。WinPanel是为了兼容而提供的。
    11.                     对于GUI风格的独立性，我们建议使用StyledPanel代替。
    12. */
    13. // 获取边框形状
    14. Shape frameShape() const;
    15. // 设置边框形状
    16. void setFrameShape(Shape);
    19. /*
    20. Qt中关于边框的阴影(QFrame::Shadow)提供了3种样式, 分别为: 
    21.     - QFrame::Plain: 简单的,朴素的, 框架和内容与周围环境显得水平;
    22.                  使用调色板绘制QPalette::WindowText颜色(没有任何3D效果)
    23.     - QFrame::Raised: 框架和内容出现凸起;使用当前颜色组的明暗颜色绘制3D凸起线
    24.     - QFrame::Sunken: 框架及内容物凹陷;使用当前颜色组的明暗颜色绘制3D凹线
    25. */
    26. // 获取边框阴影样式
    27. Shadow frameShadow() const;
    28. // 设置边框阴影样式
    29. void setFrameShadow(Shadow);
    31. // 得到边框线宽度
    32. int lineWidth() const;
    33. // 设置边框线宽度, 默认值为1
    34. void setLineWidth(int);
    36. // 得到中线的宽度
    37. int midLineWidth() const;
    38. // 设置中线宽度, 默认值为0, 这条线会影响边框阴影的显示
    39. void setMidLineWidth(int);

    四、Group Box容器：
    1、说明：
    QGroupBox 类的父类是 QWidget, 在这种类型的窗口中可以绘制边框、给窗口指定标题，并且还支持显示复选框
    2、属性设置：
    【QT】1.5-容器 - 图4
    3、相关API：

    1. // 构造函数
    2. QGroupBox::QGroupBox(QWidget *parent = Q_NULLPTR);
    3. QGroupBox::QGroupBox(const QString &title, QWidget *parent = Q_NULLPTR);
    5. // 公共成员函数
    6. bool QGroupBox::isCheckable() const;
    7. // 设置是否在组框中显示一个复选框
    8. void QGroupBox::setCheckable(bool checkable);
    10. /*
    11. 关于对齐方式需要使用枚举类型 Qt::Alignment, 其可选项为:
    12.     - Qt::AlignLeft: 左对齐(水平方向)
    13.     - Qt::AlignRight: 右对齐(水平方向)
    14.     - Qt::AlignHCenter: 水平居中
    15.     - Qt::AlignJustify: 在可用的空间内调整文本(水平方向)
    17.     - Qt::AlignTop: 上对齐(垂直方向)
    18.     - Qt::AlignBottom: 下对齐(垂直方向)
    19.     - Qt::AlignVCenter: 垂直居中
    20. */
    21. Qt::Alignment QGroupBox::alignment() const;
    22. // 设置组框标题的对其方式
    23. void QGroupBox::setAlignment(int alignment);
    25. QString QGroupBox::title() const;
    26. // 设置组框的标题
    27. void QGroupBox::setTitle(const QString &title);
    29. bool QGroupBox::isChecked() const;
    30. // 设置组框中复选框的选中状态
    31. [slot] void QGroupBox::setChecked(bool checked);

    五、Scroll Area容器：
    1、说明：
    ScrollArea 这种类型的容器，里边可以放置一些窗口控件，当放置的窗口控件大于当前区域导致无法全部显示的时候, 滚动区域容器会自动添加相应的滚动条(水平方向或者垂直方向), 保证放置到该区域中的所有窗口内容都可以正常显示出来
    2、属性设置：
    【QT】1.5-容器 - 图5
    3、相关API：

    1. // 构造函数
    2. QScrollArea::QScrollArea(QWidget *parent = Q_NULLPTR);
    4. // 公共成员函数
    5. // 给滚动区域设置要显示的子窗口widget
    6. void QScrollArea::setWidget(QWidget *widget);
    7. // 删除滚动区域中的子窗口, 并返回被删除的子窗口对象
    8. QWidget *QScrollArea::takeWidget();
    10. /*
    11. 关于显示位置的设定, 是一个枚举类型, 可选项为:
    12.     - Qt::AlignLeft: 左对齐
    13.     - Qt::AlignHCenter: 水平居中
    14.     - Qt::AlignRight: 右对齐
    15.     - Qt::AlignTop: 顶部对齐
    16.     - Qt::AlignVCenter: 垂直对其
    17.     - Qt::AlignBottom: 底部对其
    18. */
    19. // 获取子窗口在滚动区域中的显示位置
    20. Qt::Alignment alignment() const;
    21. // 设置滚动区域中子窗口的对其方式, 默认显示的位置是右上
    22. void setAlignment(Qt::Alignment);
    24. // 判断滚动区域是否有自动调节小部件大小的属性
    25. bool widgetResizable() const;
    26. /*
    27. 1. 设置滚动区域是否应该调整视图小部件的大小, 该属性默认为false, 滚动区域按照小部件的默认大小进行显示。
    28. 2. 如果该属性设置为true，滚动区域将自动调整小部件的大小，避免滚动条出现在本可以避免的地方，
    29.    或者利用额外的空间。
    30. 3. 不管这个属性是什么，我们都可以使用widget()->resize()以编程方式调整小部件的大小，
    31.    滚动区域将自动调整自己以适应新的大小。
    32. */
    33. void setWidgetResizable(bool resizable);

    六、Tool Box容器：
    1、说明：
    QToolBox 工具箱控件，可以存储多个子窗口，该控件可以实现类似 QQ 的抽屉效果，每一个抽屉都可以设置图标和标题，并且对应一个子窗口，通过抽屉按钮就可以实现各个子窗口显示的切换
    2、属性设置：
    【QT】1.5-容器 - 图6
    3、相关API:

    1. // 构造函数
    2. QToolBox::QToolBox(QWidget *parent = Q_NULLPTR, Qt::WindowFlags f = Qt::WindowFlags());
    4. // 公共成员
    5. /*
    6. addItem(), insertItem()函数相关参数:
    7.     - widget: 添加到工具箱中的选项卡对应的子窗口对象
    8.     - icon: 工具箱新的选项卡上显示的图标
    9.     - text: 工具箱新的选项卡上显示的标题
    10.     - index: 指定在工具箱中插入的新的选项卡的位置
    11. */
    12. // 给工具箱尾部添加一个选项卡, 每个选项卡在工具箱中就是一个子窗口, 即参数widget
    13. int QToolBox::addItem(QWidget *widget, const QString &text);
    14. int QToolBox::addItem(QWidget *widget, const QIcon &icon, const QString &text);
    15. // 在工具箱的指定位置添加一个选项卡, 即添加一个子窗口
    16. int QToolBox::insertItem(int index, QWidget *widget, const QString &text);
    17. int QToolBox::insertItem(int index, QWidget *widget, const QIcon &icon, 
    18.                          const QString &text);
    19. // 移除工具箱中索引index位置对应的选项卡, 注意: 只是移除对应的窗口对象并没有被销毁
    20. void QToolBox::removeItem(int index);
    22. // 设置索引index位置的选项卡是否可用, 参数 enabled=true为可用, enabled=false为禁用
    23. void QToolBox::setItemEnabled(int index, bool enabled);
    24. // 设置工具箱中index位置选项卡的图标
    25. void QToolBox::setItemIcon(int index, const QIcon &icon);
    26. // 设置工具箱中index位置选项卡的标题
    27. void QToolBox::setItemText(int index, const QString &text);
    28. // 设置工具箱中index位置选项卡的提示信息(需要鼠标在选项卡上悬停一定时长才能显示)
    29. void QToolBox::setItemToolTip(int index, const QString &toolTip);
    31. // 如果位置索引的项已启用，则返回true;否则返回false。
    32. bool QToolBox::isItemEnabled(int index) const;
    33. // 返回位置索引处项目的图标，如果索引超出范围，则返回空图标。
    34. QIcon QToolBox::itemIcon(int index) const;
    35. // 返回位于位置索引处的项的文本，如果索引超出范围，则返回空字符串。
    36. QString QToolBox::itemText(int index) const;
    37. // 返回位于位置索引处的项的工具提示，如果索引超出范围，则返回空字符串。
    38. QString QToolBox::itemToolTip(int index) const;
    40. // 得到当前工具箱中显示的选项卡对应的索引
    41. int QToolBox::currentIndex() const;
    42. // 返回指向当前选项卡对应的子窗口的指针，如果没有这样的项，则返回0。
    43. QWidget *QToolBox::currentWidget() const;
    44. // 返回工具箱中子窗口的索引，如果widget对象不存在，则返回-1
    45. int QToolBox::indexOf(QWidget *widget) const;
    46. // 返回工具箱中包含的项的数量。
    47. int QToolBox::count() const;
    49. // 信号
    50. // 工具箱中当前显示的选项卡发生变化, 该信号被发射, index为当前显示的新的选项卡的对应的索引
    51. [signal] void QToolBox::currentChanged(int index);
    53. // 槽函数
    54. // 通过工具箱中选项卡对应的索引设置当前要显示哪一个选项卡中的子窗口
    55. [slot] void QToolBox::setCurrentIndex(int index);
    56. // 通过工具箱中选项卡对应的子窗口对象设置当前要显示哪一个选项卡中的子窗口
    57. [slot] void QToolBox::setCurrentWidget(QWidget *widget);

    七、Tab Widget容器：
    1、说明：
    QTabWidget 的一种带标签页的窗口，在这种类型的窗口中可以存储多个子窗口，每个子窗口的显示可以通过对应的标签进行切换
    2、属性设置：
    【QT】1.5-容器 - 图7
    3、相关API：

    1. // 构造函数
    2. QTabWidget::QTabWidget(QWidget *parent = Q_NULLPTR);
    4. // 公共成员函数
    5. /*
    6. 添加选项卡addTab()或者插入选项卡insertTab()函数相关的参数如下:
    7.     - page: 添加或者插入的选项卡对应的窗口实例对象
    8.     - label: 添加或者插入的选项卡的标题
    9.     - icon: 添加或者插入的选项卡的图标
    10.     - index: 将新的选项卡插入到索引index的位置上
    11. */
    12. int QTabWidget::addTab(QWidget *page, const QString &label);
    13. int QTabWidget::addTab(QWidget *page, const QIcon &icon, const QString &label);
    14. int QTabWidget::insertTab(int index, QWidget *page, const QString &label);
    15. int QTabWidget::insertTab(int index, QWidget *page, 
    16.                           const QIcon &icon, const QString &label);
    17. // 删除index位置的选项卡
    18. void QTabWidget::removeTab(int index);
    20. // 得到选项卡栏中的选项卡的数量
    21. int count() const;
    22. // 从窗口中移除所有页面，但不删除它们。调用这个函数相当于调用removeTab()，直到选项卡小部件为空为止。
    23. void QTabWidget::clear();
    24. // 获取当前选项卡对应的索引
    25. int QTabWidget::currentIndex() const;
    26. // 获取当前选项卡对应的窗口对象地址
    27. QWidget *QTabWidget::currentWidget() const;
    28. // 返回索引位置为index的选项卡页，如果索引超出范围则返回0。
    29. QWidget *QTabWidget::widget(int index) const;
    31. /*
    32. 标签上显示的文本样式为枚举类型 Qt::TextElideMode, 可选项为:
    33.     - Qt::ElideLeft: 省略号应出现在课文的开头，例如：.....是的,我很帅。
    34.     - Qt::ElideRight: 省略号应出现在文本的末尾，例如：我帅吗.....。
    35.     - Qt::ElideMiddle: 省略号应出现在文本的中间，例如：我帅.....很帅。
    36.     - Qt::ElideNone: 省略号不应出现在文本中
    37. */
    38. // 获取标签上显示的文本模式
    39. Qt::TextElideMode QTabWidget::elideMode() const;
    40. // 如何省略标签栏中的文本, 此属性控制在给定的选项卡栏大小没有足够的空间显示项时如何省略项。
    41. void QTabWidget::setElideMode(Qt::TextElideMode);
    43. // 得到选项卡上图标的尺寸信息
    44. QSize QTabWidget::iconSize() const
    45. // 设置选项卡上显示的图标大小
    46. void QTabWidget::setIconSize(const QSize &size)
    48. // 判断用户是否可以在选项卡区域内移动选项卡, 可以返回true, 否则返回false
    49. bool QTabWidget::isMovable() const;
    50. // 此属性用于设置用户是否可以在选项卡区域内移动选项卡。默认情况下，此属性为false;
    51. void QTabWidget::setMovable(bool movable);
    53. // 判断选项卡是否可以自动隐藏, 如果可以自动隐藏返回true, 否则返回false
    54. bool QTabWidget::tabBarAutoHide() const;
    55. // 如果为true，则当选项卡栏包含少于2个选项卡时，它将自动隐藏。默认情况下，此属性为false。
    56. void QTabWidget::setTabBarAutoHide(bool enabled);
    58. // 判断index对应的选项卡是否是被启用的, 如果是被启用的返回true, 否则返回false
    59. bool QTabWidget::isTabEnabled(int index) const;
    60. // 如果enable为true，则在索引位置的页面是启用的;否则，在位置索引处的页面将被禁用。
    61. void QTabWidget::setTabEnabled(int index, bool enable);
    63. // 得到index位置的标签对应的图标
    64. QIcon QTabWidget::tabIcon(int index) const;
    65. // 在位置索引处设置标签的图标。
    66. void QTabWidget::setTabIcon(int index, const QIcon &icon);
    68. /*
    69. 选项卡标签的位置通过枚举值进行指定, 可使用的选项如下:
    70.     - QTabWidget::North: 北(上), 默认
    71.     - QTabWidget::South: 南(下)
    72.     - QTabWidget::West:     西(左)
    73.     - QTabWidget::East:  东(右)
    74. */
    75. // 得到选项卡中显示的标签的位置, 即: 东, 西, 南, 北
    76. TabPosition QTabWidget::tabPosition() const;
    77. // 设置选项卡中标签显示的位置, 默认情况下，此属性设置为North。
    78. void QTabWidget::setTabPosition(TabPosition);
    80. /*
    81. 选项卡标签的形状通过枚举值进行指定, 可使用的选项如下:
    82.     - QTabWidget::Rounded: 标签以圆形的外观绘制。这是默认形状
    83.     - QTabWidget::Triangular: 选项卡以三角形外观绘制。
    84. */
    85. // 获得选项卡标签的形状
    86. TabShape QTabWidget::tabShape() const;
    87. // 设置选项卡标签的形状
    88. void QTabWidget::setTabShape(TabShape s);
    90. // 得到index位置的标签的标题
    91. QString QTabWidget::tabText(int index) const;
    92. // 设置选项卡index位置的标签的标题
    93. void QTabWidget::setTabText(int index, const QString &label);
    96. // 获取index对应的标签页上设置的提示信息
    97. QString QTabWidget::tabToolTip(int index) const;
    98. // 设置选项卡index位置的标签的提示信息(鼠标需要悬停在标签上一定时长才能显示)
    99. void QTabWidget::setTabToolTip(int index, const QString &tip);
    102. // 判断选项卡标签也上是否有关闭按钮, 如果有返回true, 否则返回false
    103. bool QTabWidget::tabsClosable() const;
    104. // 设置选项卡的标签页上是否显示关闭按钮, 该属性默认情况下为false
    105. void QTabWidget::setTabsClosable(bool closeable);
    108. // 判断选项卡栏中是否有滚动按钮, 如果有返回true, 否则返回false
    109. bool QTabWidget::usesScrollButtons() const;
    110. // 设置选项卡栏有许多标签时，它是否应该使用按钮来滚动标签。
    111. // 当一个选项卡栏有太多的标签时，选项卡栏可以选择扩大它的大小，或者添加按钮，让标签在选项卡栏中滚动。
    112. void QTabWidget::setUsesScrollButtons(bool useButtons);
    114. // 判断窗口是否设置了文档模式, 如果设置了返回true, 否则返回false
    115. bool QTabWidget::documentMode() const;
    116. // 此属性保存选项卡小部件是否以适合文档页面的模式呈现。这与macOS上的文档模式相同。
    117. // 不设置该属性, QTabWidget窗口是带边框的, 如果设置了该属性边框就没有了。
    118. void QTabWidget::setDocumentMode(bool set);

    4、信号：

    1. // 每当当前页索引改变时，就会发出这个信号。参数是新的当前页索引位置，如果没有新的索引位置，则为-1
    2. [signal] void QTabWidget::currentChanged(int index);
    3. // 当用户单击索引处的选项卡时，就会发出这个信号。index指所单击的选项卡，如果光标下没有选项卡，则为-1。
    4. [signal] void QTabWidget::tabBarClicked(int index)
    5. // 当用户双击索引上的一个选项卡时，就会发出这个信号。
    6. // index是单击的选项卡的索引，如果光标下没有选项卡，则为-1。
    7. [signal] void QTabWidget::tabBarDoubleClicked(int index);
    8. // 此信号在单击选项卡上的close按钮时发出。索引是应该被删除的索引。     
    9. [signal] void QTabWidget::tabCloseRequested(int index);

    5、槽函数：

    1. // 设置当前窗口中显示选项卡index位置对应的标签页内容
    2. [slot] void QTabWidget::setCurrentIndex(int index);
    3. // 设置当前窗口中显示选项卡中子窗口widget中的内容
    4. [slot] void QTabWidget::setCurrentWidget(QWidget *widget);

    七、Stacked Widget容器：
    1、说明：
    QStackedWidget 栈类型窗口，在这种类型的窗口中可以存储多个子窗口，但是只有其中某一个可以被显示出来，至于是哪个子窗口被显示，需要在程序中进行控制，在这种类型的窗口中没有直接切换子窗口的按钮或者标签
    2、相关API：
    在这些函数中最常用的就是槽函数，并且名字和 QToolBox, QTabWidget 两个类提供的槽函数名字相同分别为 setCurrentIndex(int)，setCurrentWidget(QWidget*) 用来设置当前显示的窗口

    1. // 构造函数
    2. QStackedWidget::QStackedWidget(QWidget *parent = Q_NULLPTR);
    4. // 公共成员函数
    5. // 在栈窗口中后边添加一个子窗口, 返回这个子窗口在栈窗口中的索引值(从0开始计数)
    6. int QStackedWidget::addWidget(QWidget *widget);
    7. // 将子窗口widget插入到栈窗口的index位置
    8. int QStackedWidget::insertWidget(int index, QWidget *widget);
    9. // 将子窗口widget从栈窗口中删除
    10. void QStackedWidget::removeWidget(QWidget *widget);
    12. // 返回栈容器窗口中存储的子窗口的个数
    13. int QStackedWidget::count() const;
    14. // 得到当前栈窗口中显示的子窗口的索引
    15. int QStackedWidget::currentIndex() const;
    16. // 得到当前栈窗口中显示的子窗口的指针(窗口地址)
    17. QWidget *QStackedWidget::currentWidget() const;
    18. // 基于索引index得到栈窗口中对应的子窗口的指针
    19. QWidget *QStackedWidget::widget(int index) const;
    20. // 基于子窗口的指针(实例地址)得到其在栈窗口中的索引
    21. int QStackedWidget::indexOf(QWidget *widget) const;
    23. // 信号
    24. // 切换栈窗口中显示子窗口, 该信息被发射出来, index为新的当前窗口对应的索引值
    25. [signal] void QStackedWidget::currentChanged(int index);
    26. // 当栈窗口的子窗口被删除, 该信号被发射出来, index为被删除的窗口对应的索引值
    27. [signal] void QStackedWidget::widgetRemoved(int index);
    29. // 槽函数
    30. // 基于子窗口的index索引指定当前栈窗口中显示哪一个子窗口
    31. [slot] void QStackedWidget::setCurrentIndex(int index);
    32. [slot] void QStackedWidget::setCurrentWidget(QWidget *widget);

    3、属性设置：
    【QT】1.5-容器 - 图8
    【QT】1.5-容器 - 图9