简述
QSizePolicy类是一个描述布局水平和垂直方向调整策略的属性。
大小策略会影响布局引擎处理部件的方式,部件加入布局以后,会返回一个QSizePolicy,描述了其水平和垂直方向的大小策略。可以通过QWidget::sizePolicy属性为特定部件设置大小策略。
详细描述
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对象,获取它们的控制类型:
1 QLabel *pLabel = new QLabel(this);
2 QTableWidget *pTableWidget = new QTableWidget(this);
3
4 // 获取大小策略
5 QSizePolicy labelSizePolicy = pLabel->sizePolicy();
6 QSizePolicy tableSizePolicy = pTableWidget->sizePolicy();
7
8 // 获取控制类型
9 QSizePolicy::ControlType labelType = labelSizePolicy.controlType(); //QSizePolicy::Label
10 QSizePolicy::ControlType tableType = tableSizePolicy.controlType(); //QSizePolicy::DefaultType
参照枚举QSizePolicy::ControlType对应的常量表,我们很容易发现:QLabel所对应的控制类型为QSizePolicy::Label,而QTableWidget所对应的控制类型为QSizePolicy::DefaultType。
QSizePolicy
为了测试大小策略及缩放因子,我们来构建一个Windows中最常见的资源管理器:
默认效果
效果
源码
1 QTreeWidget *pTreeWidget = new QTreeWidget(this);
2 QTableWidget *pTableWidget = new QTableWidget(this);
3
4 ...
5
6 QHBoxLayout *pLayout = new QHBoxLayout();
7 pLayout->addWidget(pTreeWidget);
8 pLayout->addWidget(pTableWidget);
9 pLayout->setSpacing(10);
10 pLayout->setContentsMargins(10, 10, 10, 10);
11
12 setLayout(pLayout);
13
14 // 获取大小策略
15 QSizePolicy treeSizePolicy = pTreeWidget->sizePolicy();
16 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。
1 QTreeWidget *pTreeWidget = new QTreeWidget(this);
2 QTableWidget *pTableWidget = new QTableWidget(this);
3
4 ...
5
6 QHBoxLayout *pLayout = new QHBoxLayout();
7 pLayout->addWidget(pTreeWidget);
8 pLayout->addWidget(pTableWidget);
9 pLayout->setSpacing(10);
10 pLayout->setContentsMargins(10, 10, 10, 10);
11
12 setLayout(pLayout);
13
14 // 获取大小策略
15 QSizePolicy treeSizePolicy = pTreeWidget->sizePolicy();
16 QSizePolicy tableSizePolicy = pTableWidget->sizePolicy();
17
18 treeSizePolicy.setHorizontalPolicy(QSizePolicy::Maximum);
19 pTreeWidget->setSizePolicy(treeSizePolicy);
20 tableSizePolicy.setHorizontalPolicy(QSizePolicy::Expanding);
21 pTableWidget->setSizePolicy(tableSizePolicy);
缩放因子控制
当界面缩放时,为了保持一定的比例,右边的QTableWidget永远是左边QTreeWidget的2倍,我们可以通过setHorizontalStretch()来设置缩放因子。
效果
源码
1 QTreeWidget *pTreeWidget = new QTreeWidget(this);
2 QTableWidget *pTableWidget = new QTableWidget(this);
3
4 ...
5
6 QHBoxLayout *pLayout = new QHBoxLayout();
7 pLayout->addWidget(pTreeWidget);
8 pLayout->addWidget(pTableWidget);
9 pLayout->setSpacing(10);
10 pLayout->setContentsMargins(10, 10, 10, 10);
11
12 setLayout(pLayout);
13
14 // 获取大小策略
15 QSizePolicy treeSizePolicy = pTreeWidget->sizePolicy();
16 QSizePolicy tableSizePolicy = pTableWidget->sizePolicy();
17
18 treeSizePolicy.setHorizontalStretch(1);
19 tableSizePolicy.setHorizontalStretch(2);
20 pTreeWidget->setSizePolicy(treeSizePolicy);
21 pTableWidget->setSizePolicy(tableSizePolicy);
这样,就可以很很好地根据大小策略及缩放因子来控制界面效果了。你也可以进行任意组合,不妨试试。