QGridLayout Class

成员函数文档

[explicit] QGridLayout::QGridLayout(QWidget *parent = nullptr)

使用父控件parent 创建一个新的 QGridLayout。该布局初始时包含一行一列，并在插入新项目时自动扩展。

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

如果parent 是nullptr ，则必须将此网格布局插入到另一个布局中，或者使用QWidget::setLayout()将其设置为小部件的布局。

另请参阅 QWidget::setLayout()。

[virtual noexcept] QGridLayout::~QGridLayout()

破坏网格布局。如果这是一个顶级网格，则几何管理将被终止。

布局中的控件不会被销毁。

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

重写了：QLayout::addItem(QLayoutItem *item)。

void QGridLayout::addItem(QLayoutItem *item, int row, int column, int rowSpan = 1, int columnSpan = 1, Qt::Alignment alignment = Qt::Alignment())

在位置row 、column 处添加item ，其尺寸为rowSpan 行和columnSpan 列，并根据alignment 进行对齐。如果rowSpan 和/或columnSpan 为 -1，则该项将分别延伸至底部和/或右侧边缘。该布局将接管item 的所有权。

void QGridLayout::addLayout(QLayout *layout, int row, int column, Qt::Alignment alignment = Qt::Alignment())

将layout 放置在网格的坐标位置 (row,column) 处。左上角坐标为 (0, 0)。

对齐方式由alignment 指定。默认对齐值为 0，这意味着该小部件将填满整个单元格。

非零对齐值表示布局不应扩展以填满可用空间，而应根据sizeHint()进行尺寸调整。

layout 成为网格布局的子控件。

void QGridLayout::addLayout(QLayout *layout, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())

此版本在单元格网格中新增了layout 布局，该布局横跨多行/多列。该单元格将从row 、column 开始，横跨rowSpan 行和columnSpan 列。

如果rowSpan 和/或columnSpan 为-1，则布局将分别延伸至底部和/或右侧边缘。

void QGridLayout::addWidget(QWidget *widget, int row, int column, Qt::Alignment alignment = Qt::Alignment())

将给定的widget 添加到位于row 、column 的单元格网格中。默认情况下，左上角位置为(0, 0)。

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

void QGridLayout::addWidget(QWidget *widget, int fromRow, int fromColumn, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())

此版本将给定的widget 添加到单元格网格中，并横跨多行/多列。该单元格将从fromRow 、fromColumn 开始，横跨rowSpan 行和columnSpan 列。widget 将具有给定的alignment 。

如果rowSpan 和/或columnSpan 的值为 -1，则控件将分别延伸至底部和/或右侧边缘。

QRect QGridLayout::cellRect(int row, int column) const

返回网格中行号为row 、列号为column 的单元格的几何信息。如果row 或column 位于网格之外，则返回一个无效的矩形。

int QGridLayout::columnCount() const

返回此网格中的列数。

int QGridLayout::columnMinimumWidth(int column) const

返回列column 的列间距。

另请参阅 setColumnMinimumWidth()。

int QGridLayout::columnStretch(int column) const

返回列column 的拉伸因子。

另请参阅 setColumnStretch()。

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

重新实现了：QLayout::count() const。

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

重新实现了：QLayout::expandingDirections() const。

void QGridLayout::getItemPosition(int index, int *row, int *column, int *rowSpan, int *columnSpan) const

返回具有给定index 的项目的位置信息。

作为row 和column 传递的变量将被更新为该项在布局中的位置，而rowSpan 和columnSpan 变量将被更新为该项的垂直和水平跨度。

另请参阅 itemAtPosition() 和itemAt()。

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

重新实现了：QLayoutItem::hasHeightForWidth() const。

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

重新实现了：QLayoutItem::heightForWidth(int) const。

[override virtual] void QGridLayout::invalidate()

重写了：QLayout::invalidate()。

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

重新实现了：QLayout::itemAt(int index) const。

QLayoutItem *QGridLayout::itemAtPosition(int row, int column) const

返回占据单元格 (row,column) 的布局项，如果单元格为空，则返回nullptr 。

另请参阅 getItemPosition() 和indexOf()。

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

重新实现了：QLayout::maximumSize() const。

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

重新实现了：QLayoutItem::minimumHeightForWidth(int w) const。

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

重新实现了：QLayout::minimumSize() const。

Qt::Corner QGridLayout::originCorner() const

返回用作网格原点的角点，即坐标 (0, 0) 所在的位置。

另请参阅 setOriginCorner()。

int QGridLayout::rowCount() const

返回此网格中的行数。

int QGridLayout::rowMinimumHeight(int row) const

返回行row 所设置的最小宽度。

另请参阅 setRowMinimumHeight()。

int QGridLayout::rowStretch(int row) const

返回行row 的拉伸因子。

另请参阅 setRowStretch()。

void QGridLayout::setColumnMinimumWidth(int column, int minSize)

将column 列的最小宽度设置为minSize 像素。

另请参阅 columnMinimumWidth() 和setRowMinimumHeight()。

void QGridLayout::setColumnStretch(int column, int stretch)

将列column 的拉伸因子设置为stretch 。第一列的编号为0。

伸缩因子是相对于该网格中其他列而言的。伸缩因子较高的列将占据更多的可用空间。

默认拉伸因子为 0。如果拉伸因子为 0，且该表中没有其他列能够扩展，则该列仍可能扩展。

另一种方法是使用 `addItem()` 并指定 `QSpacerItem` 来添加间距。

另请参阅 columnStretch() 和setRowStretch()。

[override virtual] void QGridLayout::setGeometry(const QRect &rect)

重新实现了：QLayout::setGeometry(const QRect &r)。

void QGridLayout::setOriginCorner(Qt::Corner corner)

将网格的原点（即位置 (0, 0)）设置为corner 。

另请参阅 originCorner()。

void QGridLayout::setRowMinimumHeight(int row, int minSize)

将行row 的最小高度设置为minSize 像素。

另请参阅 rowMinimumHeight() 和setColumnMinimumWidth()。

void QGridLayout::setRowStretch(int row, int stretch)

将第row 行的拉伸因子设置为stretch 。第一行编号为0。

拉伸因子是相对于该网格中其他行而言的。拉伸因子较高的行将占据更多的可用空间。

默认拉伸因子为 0。如果拉伸因子为 0，且该表格中没有其他行能够扩展，则该行仍可能扩展。

另请参阅 rowStretch()、setRowMinimumHeight() 以及setColumnStretch()。

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

重新实现了属性QLayout::spacing 的访问函数。

该函数将垂直和水平间距均设置为spacing 。

另请参阅 spacing()、setVerticalSpacing() 和setHorizontalSpacing()。

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

重新实现了：QLayoutItem::sizeHint() const。

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

重新实现属性QLayout::spacing 的访问函数。

如果垂直间距等于水平间距，则该函数返回该值；否则返回 -1。

另请参阅 setSpacing()、verticalSpacing() 以及horizontalSpacing()。

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

重写了：QLayout::takeAt(int index)。