Qt之QSizePolicy

简述

QSizePolicy类是一个描述布局水平和垂直方向调整策略的属性。

大小策略会影响布局引擎处理部件的方式，部件加入布局以后，会返回一个QSizePolicy，描述了其水平和垂直方向的大小策略。可以通过QWidget::sizePolicy属性为特定部件设置大小策略。

• 简述
• 详细描述
• 成员类型
• 公共函数
• 示例
  • 控制类型
  • QSizePolicy
  • 默认效果
    • 效果
    • 源码
  • 大小策略控制
    • 效果
    • 源码
  • 缩放因子控制
    • 效果
    • 源码

详细描述

QSizePolicy包含了两个独立的QSizePolicy::Policy值和两个缩放因子，一个描述了部件水平方向上的大小策略，另一个描述了垂直方向上的大小策略。它还包含一个标志表明高度和宽度是否与首选大小有关。

水平和垂直方向的大小策略可以在构造函数中设置，也可以通过setHorizontalPolicy()和setVerticalPolicy()函数改变。缩放因子可以使用setHorizontalStretch()和setVerticalStretch()函数设置。setHeightForWidth()函数的标志表示部件的缺省大小（sizeHint()）是否是width-dependent（例如：菜单栏或自动换行标签） 。

可以使用horizontalPolicy()、verticalPolicy()、horizontalStretch()和verticalStretch()函数来返回当前的大小策略和缩放因子。另外，使用transpose()函数可以互换水平和垂直的大小策略和缩放因子。hasHeightForWidth()函数返回了当前状态表示的大小依赖性。

为了确定相关的部件是否可以比sizeHint()函数利用更多的空间，可以使用expandingDirections()函数，通过它，还可以找出哪个方向可以展开。

最后，QSizePolicy类可以进行大小策略之间的比较，并且可以用QVariant来存储QSizePolicy。

成员类型

• 枚举QSizePolicy::ControlType：

  指定了布局交互时不同的部件类型。

常量	值	描述
QSizePolicy::DefaultType	0x00000001	默认类型，当没有指定时
QSizePolicy::ButtonBox	0x00000002	一个QDialogButtonBox实例
QSizePolicy::CheckBox	0x00000004	一个QCheckBox实例
QSizePolicy::ComboBox	0x00000008	一个QComboBox实例
QSizePolicy::Frame	0x00000010	一个QFrame实例
QSizePolicy::GroupBox	0x00000020	一个QGroupBox实例
QSizePolicy::Label	0x00000040	一个QLabel实例
QSizePolicy::Line	0x00000080	一个QFrame::HLine或QFrame::VLine的QFrame实例
QSizePolicy::LineEdit	0x00000100	一个QLineEdit实例
QSizePolicy::PushButton	0x00000200	一个QPushButton实例
QSizePolicy::RadioButton	0x00000400	一个QRadioButton实例
QSizePolicy::Slider	0x00000800	一个QAbstractSlider实例
QSizePolicy::SpinBox	0x00001000	一个QAbstractSpinBox实例
QSizePolicy::TabWidget	0x00002000	一个QTabWidget实例
QSizePolicy::ToolButton	0x00004000	一个QToolButton实例

• 枚举QSizePolicy::Policy

  当使用QSizePolicy时，描述了一系列线性维度大小策略。

常量	值	描述
QSizePolicy::Fixed	0	缺省大小是唯一可以接收的改变，因此部件不能放大也不能缩小。
QSizePolicy::Minimum	GrowFlag	缺省大小是最小值，并且是充分的。部件允许扩展，但是并不倾向扩展（例如：水平方向上的按钮），不能比缺省大小提供的大小更小。
QSizePolicy::Maximum	ShrinkFlag	缺省大小是最大值，假如其它部件需要空间并且不会破坏该部件，那么该部件允许被缩小（例如：一个分割线）。
QSizePolicy::Preferred	GrowFlag | ShrinkFlag	缺省大小是最佳效果，部件允许放大或缩小，但不倾向于扩展比sizeHint()大（QWidget的缺省策略）。
QSizePolicy::Expanding	GrowFlag | ShrinkFlag | ExpandFlag	缺省大小是合理的大小，但部件允许缩小并且可用。部件可以利用额外的空间，因此它将会得到尽可能多的空间（例如：水平方向上的滑块）。
QSizePolicy::MinimumExpanding	GrowFlag | ExpandFlag	缺省大小是最小值，并且是足够的。部件允许使用额外空间，因此它将会得到尽可能多的空间（例如：水平方向上的滑块）。
QSizePolicy::Ignored	ShrinkFlag | GrowFlag | IgnoreFlag	缺省大小将会被忽略，部件将会得到尽可能多的空间。

• 枚举QSizePolicy::PolicyFlag

  这些标志被组合在一起，以形成一系列大小策略值。

常量	值	描述
QSizePolicy::GrowFlag	1	部件可以在必要时增长至超过它的尺寸。
QSizePolicy::ExpandFlag	2	部件应该得到尽可能多的空间。
QSizePolicy::ShrinkFlag	4	部件可以在必要时缩小至小于它的尺寸。
QSizePolicy::IgnoreFlag	8	部件的缺省大小被忽略，它将会得到尽可能多的空间。

公共函数

• ControlType QSizePolicy::controlType() const
  
  返回部件大小策略所依赖的控制类型

• Qt::Orientations QSizePolicy::expandingDirections() const
  
  返回一个部件是否可以比QWidget::sizeHint()使用更多的空间

  Qt::Horizontal 或 Qt::Vertical意味着可以在水平或垂直方向上伸展（例如：水平或垂直策略是Expanding或MinimumExpanding），然而Qt::Horizontal | Qt::Vertical意味着可以在两个方向上均可以伸展。

• bool QSizePolicy::hasHeightForWidth() const
  
  如果部件的首选高度依赖于它的宽度，则返回true；否则，返回false。

• bool QSizePolicy::hasWidthForHeight() const
  
  如果部件的宽度取决于其高度，则返回true；否则返回false。

• Policy QSizePolicy::horizontalPolicy() const
  
  返回水平方向上的大小策略

• int QSizePolicy::horizontalStretch() const
  
  返回水平方向上大小策略的缩放因子

• bool QSizePolicy::retainSizeWhenHidden() const
  
  部件被隐藏时，返回布局是否应保留它的尺寸，默认为false。

• void QSizePolicy::setControlType(ControlType type)
  
  设置部件大小策略所依赖的控制类型

• void QSizePolicy::setHeightForWidth(bool dependent)
  
  设置标志判断窗口部件的首选高度是否依赖于它的宽度。

• void QSizePolicy::setHorizontalPolicy(Policy policy)
  
  设置水平方向上的大小策略

• void QSizePolicy::setHorizontalStretch(int stretchFactor)
  
  设置水平大小策略的缩放因子，取值范围[0,255]。

  当两个部件在一个水平布局中彼此相邻，如果左侧的缩放因子设置为2，右侧的缩放因子设置为1，那么，左侧部件大小将总是右边的两倍。

• void QSizePolicy::setRetainSizeWhenHidden(bool retainSize)
  
  当部件被隐藏时，设置其所在布局是否应保留它的大小。如果为true，布局将不被隐藏部件所改变。

• void QSizePolicy::setVerticalPolicy(Policy policy)
  
  设置垂直方向上的大小策略

• void QSizePolicy::setVerticalStretch(int stretchFactor)
  
  设置垂直大小策略的缩放因子，取值范围[0,255]。

• void QSizePolicy::setWidthForHeight(bool dependent)
  
  设置标志确定部件的宽度是否依赖于它的高度。

  仅支持QGraphicsLayout的子类，不可能有布局同时存在height-for-width和width-for-height。

• void QSizePolicy::transpose()
  
  互换水平和垂直策略和伸展。

• Policy QSizePolicy::verticalPolicy() const
  
  返回垂直方向上的大小策略

• int QSizePolicy::verticalStretch() const
  
  返回垂直方向上大小策略的缩放因子

示例

控制类型

下面，构建一个QLabel及QTableWidget对象，获取它们的控制类型：

QLabel *pLabel = new QLabel(this);
QTableWidget *pTableWidget = new QTableWidget(this);
// 获取大小策略
QSizePolicy labelSizePolicy = pLabel->sizePolicy();
QSizePolicy tableSizePolicy = pTableWidget->sizePolicy();
// 获取控制类型
QSizePolicy::ControlType labelType = labelSizePolicy.controlType();  //QSizePolicy::Label
QSizePolicy::ControlType tableType = tableSizePolicy.controlType();  //QSizePolicy::DefaultType

参照枚举QSizePolicy::ControlType对应的常量表，我们很容易发现：QLabel所对应的控制类型为QSizePolicy::Label，而QTableWidget所对应的控制类型为QSizePolicy::DefaultType。

QSizePolicy

为了测试大小策略及缩放因子，我们来构建一个Windows中最常见的资源管理器：

默认效果

效果

源码

QTreeWidget *pTreeWidget = new QTreeWidget(this);
QTableWidget *pTableWidget = new QTableWidget(this);
...
QHBoxLayout *pLayout = new QHBoxLayout();
pLayout->addWidget(pTreeWidget);
pLayout->addWidget(pTableWidget);
pLayout->setSpacing(10);
pLayout->setContentsMargins(10, 10, 10, 10);
setLayout(pLayout);
// 获取大小策略
QSizePolicy treeSizePolicy = pTreeWidget->sizePolicy();
QSizePolicy tableSizePolicy = pTableWidget->sizePolicy();

将QTreeWidget和QTableWidget加入布局后，分别获取它们的大小策略，可以很容易的发现水平和垂直方向的值均为7。

7代表什么？

由于QSizePolicy::Policy由QSizePolicy::PolicyFlag组合而成，所以可以很轻易地发现对应的值是：QSizePolicy::Expanding，递推分析：7 = (1 | 2 | 4) = (QSizePolicy::GrowFlag | QSizePolicy::ExpandFlag | QSizePolicy::ShrinkFlag) = QSizePolicy::Expanding。

可以看出，它们同时缩小、同时放大，并且等比均匀划分。

大小策略控制

当界面缩小时，我们尽可能的让左边的QTreeWidget缩小；而界面放大时，尽可能的让右边的TableView放大，且QTreeWidget达到缺省宽度时就不会被放大。

效果

源码

通过使用QSizePolicy::Maximum来控制，具体说明，请参考枚举QSizePolicy::Policy。

QTreeWidget *pTreeWidget = new QTreeWidget(this);
QTableWidget *pTableWidget = new QTableWidget(this);
...
QHBoxLayout *pLayout = new QHBoxLayout();
pLayout->addWidget(pTreeWidget);
pLayout->addWidget(pTableWidget);
pLayout->setSpacing(10);
pLayout->setContentsMargins(10, 10, 10, 10);
setLayout(pLayout);
// 获取大小策略
QSizePolicy treeSizePolicy = pTreeWidget->sizePolicy();
QSizePolicy tableSizePolicy = pTableWidget->sizePolicy();
treeSizePolicy.setHorizontalPolicy(QSizePolicy::Maximum);
pTreeWidget->setSizePolicy(treeSizePolicy);
tableSizePolicy.setHorizontalPolicy(QSizePolicy::Expanding);
pTableWidget->setSizePolicy(tableSizePolicy);

缩放因子控制

当界面缩放时，为了保持一定的比例，右边的QTableWidget永远是左边QTreeWidget的2倍，我们可以通过setHorizontalStretch()来设置缩放因子。

效果

源码

QTreeWidget *pTreeWidget = new QTreeWidget(this);
QTableWidget *pTableWidget = new QTableWidget(this);
...
QHBoxLayout *pLayout = new QHBoxLayout();
pLayout->addWidget(pTreeWidget);
pLayout->addWidget(pTableWidget);
pLayout->setSpacing(10);
pLayout->setContentsMargins(10, 10, 10, 10);
setLayout(pLayout);
// 获取大小策略
QSizePolicy treeSizePolicy = pTreeWidget->sizePolicy();
QSizePolicy tableSizePolicy = pTableWidget->sizePolicy();
treeSizePolicy.setHorizontalStretch(1);
tableSizePolicy.setHorizontalStretch(2);
pTreeWidget->setSizePolicy(treeSizePolicy);
pTableWidget->setSizePolicy(tableSizePolicy);

这样，就可以很很好地根据大小策略及缩放因子来控制界面效果了。你也可以进行任意组合，不妨试试。