QBoxLayout Class

成员函数文档

[explicit] QBoxLayout::QBoxLayout(QBoxLayout::Direction dir, QWidget *parent = nullptr)

构造一个新的 QBoxLayout，其方向为dir ，父部件为parent 。

该布局被直接设置为parent 的顶层布局。一个 widget 只能有一个顶级布局。它由QWidget::layout() 返回。

另请参阅 direction() 和QWidget::setLayout()。

[virtual noexcept] QBoxLayout::~QBoxLayout()

销毁此盒式布局。

布局的部件不会被销毁。

[override virtual] void QBoxLayout::addItem(QLayoutItem *item)

重实现：QLayout::addItem(QLayoutItem *item).

void QBoxLayout::addLayout(QLayout *layout, int stretch = 0)

在方框末尾添加layout ，序列拉伸因子为stretch 。

另请参见 insertLayout()、addItem() 和addWidget()。

void QBoxLayout::addSpacerItem(QSpacerItem *spacerItem)

将spacerItem 添加到该方框布局的末尾。

另请参阅 addSpacing() 和addStretch()。

void QBoxLayout::addSpacing(int size)

在该方框布局的末尾添加一个不可伸缩的空格（QSpacerItem ），大小为size 。QBoxLayout 提供默认的边距和间距。此函数将添加额外的空格。

另请参阅 insertSpacing(),addItem() 和QSpacerItem 。

void QBoxLayout::addStretch(int stretch = 0)

在此方框布局的末尾添加一个可拉伸空间（QSpacerItem ），其最小尺寸为零，拉伸系数为stretch 。

另请参阅 insertStretch(),addItem() 和QSpacerItem 。

void QBoxLayout::addStrut(int size)

将方框的垂直尺寸（例如，如果方框为LeftToRight ，则高度）限制为最小值size 。其他约束可能会增加限制。

另请参阅 addItem().

void QBoxLayout::addWidget(QWidget *widget, int stretch = 0, Qt::Alignment alignment = Qt::Alignment())

将widget 添加到该方框布局的末尾，拉伸系数为stretch ，对齐方式为alignment 。

拉伸系数仅适用于direction 中的QBoxLayout ，并且是相对于该QBoxLayout 中的其他框和部件而言的。拉伸系数越高的部件和方框越大。

如果拉伸系数为 0，且QBoxLayout 中其他部件的拉伸系数均大于 0，则空间将根据QWidget:sizePolicy() 中涉及的每个部件来分配。

对齐方式由alignment 指定。默认对齐方式为 0，这意味着 widget 填满了整个单元格。

另请参阅 insertWidget(),addItem(),addLayout(),addStretch(),addSpacing() 和addStrut() 。

[override virtual] int QBoxLayout::count() const

重实现：QLayout::count() const.

QBoxLayout::Direction QBoxLayout::direction() const

返回方框的方向。addWidget() 和addSpacing() 按此方向工作；拉伸按此方向伸展。

另请参阅 setDirection(),QBoxLayout::Direction,addWidget() 和addSpacing() 。

[override virtual] Qt::Orientations QBoxLayout::expandingDirections() const

重实现：QLayout::expandingDirections() const.

[override virtual] bool QBoxLayout::hasHeightForWidth() const

重实现：QLayoutItem::hasHeightForWidth() const.

[override virtual] int QBoxLayout::heightForWidth(int w) const

重实现：QLayoutItem::heightForWidth(int) const.

void QBoxLayout::insertItem(int index, QLayoutItem *item)

在index 位置将item 插入该方框布局。索引必须为负数或在 0 至count() 范围内（包括 0）。如果index 为负数或count() 为负数，项目将被添加到末尾。

另请参阅 addItem()、insertWidget()、insertLayout()、insertStretch() 和insertSpacing()。

void QBoxLayout::insertLayout(int index, QLayout *layout, int stretch = 0)

在index 位置插入layout ，拉伸因子为stretch 。如果index 为负数，布局将被添加到末尾。

layout 成为方框布局的子节点。

另请参阅 addLayout() 和insertItem()。

void QBoxLayout::insertSpacerItem(int index, QSpacerItem *spacerItem)

在index 位置插入spacerItem ，最小尺寸和拉伸系数为零。如果index 为负数，则在末尾添加空格。

另请参阅 addSpacerItem()、insertStretch() 和insertSpacing()。

void QBoxLayout::insertSpacing(int index, int size)

在index 位置插入一个不可扩展的空格（一个QSpacerItem ），大小为size 。如果index 为负数，则在末尾添加空格。

方框布局有默认的边距和间距。此函数会添加额外的空格。

另请参阅 addSpacing(),insertItem() 和QSpacerItem 。

void QBoxLayout::insertStretch(int index, int stretch = 0)

在index 位置插入一个可拉伸空格（一个QSpacerItem ），最小尺寸为零，拉伸系数为stretch 。如果index 为负数，则在末尾添加空格。

另请参阅 addStretch(),insertItem() 和QSpacerItem 。

void QBoxLayout::insertWidget(int index, QWidget *widget, int stretch = 0, Qt::Alignment alignment = Qt::Alignment())

在index 位置插入widget ，拉伸因子为stretch ，对齐方式为alignment 。如果index 为负数，则在末尾添加部件。

拉伸系数仅适用于direction 中的QBoxLayout ，并且是相对于该QBoxLayout 中的其他框和部件而言的。拉伸系数越高的部件和方框越大。

如果拉伸系数为 0，且QBoxLayout 中其他部件的拉伸系数均大于 0，则空间将根据QWidget:sizePolicy() 中涉及的每个部件来分配。

对齐方式由alignment 指定。默认对齐方式为 0，这意味着 widget 填满了整个单元格。

另请参阅 addWidget() 和insertItem()。

[override virtual] void QBoxLayout::invalidate()

重新实现：QLayout::invalidate().

重置缓存信息。

[override virtual] QLayoutItem *QBoxLayout::itemAt(int index) const

重实现：QLayout::itemAt(int index) const.

[override virtual] QSize QBoxLayout::maximumSize() const

重实现：QLayout::maximumSize() const.

[override virtual] int QBoxLayout::minimumHeightForWidth(int w) const

重实现：QLayoutItem::minimumHeightForWidth(int w) const.

[override virtual] QSize QBoxLayout::minimumSize() const

重实现：QLayout::minimumSize() const.

void QBoxLayout::setDirection(QBoxLayout::Direction direction)

将此布局的方向设置为direction 。

另请参阅 direction() 。

[override virtual] void QBoxLayout::setGeometry(const QRect &r)

重实现：QLayout::setGeometry(const QRect &r).

[override virtual] void QBoxLayout::setSpacing(int spacing)

重构属性访问函数：QLayout::spacing 。

重新实现QLayout::setSpacing().将间距属性设置为spacing 。

另请参阅 QLayout::setSpacing() 和spacing()。

void QBoxLayout::setStretch(int index, int stretch)

将位置index. 的拉伸因数设置为stretch.

另请参见 stretch().

bool QBoxLayout::setStretchFactor(QWidget *widget, int stretch)

将widget 的拉伸因子设置为stretch ，如果在此布局（不包括子布局）中找到widget ，则返回 true；否则返回false 。

另请参阅 setAlignment() 。

bool QBoxLayout::setStretchFactor(QLayout *layout, int stretch)

这是一个重载函数。

将布局layout 的拉伸因子设置为stretch ，如果在此布局（不包括子布局）中找到layout ，则返回true ；否则返回false 。

[override virtual] QSize QBoxLayout::sizeHint() const

重实现：QLayoutItem::sizeHint() const.

[override virtual] int QBoxLayout::spacing() const

重构属性访问函数：QLayout::spacing 。

重新实现QLayout::spacing() 。如果间距属性有效，则返回该值。否则，将计算并返回间距属性的值。由于 widget 中的布局间距与样式有关，如果父级是 widget，则会查询布局（水平或垂直）间距的样式。否则，如果父节点是布局，则查询父节点布局的 spacing()。

另请参阅 QLayout::spacing() 和setSpacing()。

int QBoxLayout::stretch(int index) const

返回位置index 上的拉伸因子。

另请参见 setStretch().

[override virtual] QLayoutItem *QBoxLayout::takeAt(int index)

重实现：QLayout::takeAt(int index)。