QGridLayout Class

成员函数文档

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

构造一个新的 QGridLayout，其父部件为parent 。该布局最初只有一行和一列，插入新项目时将会展开。

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

如果parent 是nullptr ，则必须将此网格布局插入到其他布局中，或使用QWidget::setLayout() 将其设置为 widget 的布局。

另请参阅 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 、跨rowSpan 行和columnSpan 列添加item ，并根据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，即窗口小部件填满整个单元格。

如果对齐方式为非 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，则 Widget 将分别延伸到底部和/或右侧边缘。

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。如果拉伸系数为 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。如果拉伸因子为 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)。