QGridLayout类

成员函数文档

[显式] QGridLayout::QGridLayout(QWidget *parent = nullptr)

使用父控件parent构建一个新的QGridLayout。布局初始时有一行一列，当插入新项目时会扩展。

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

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

另请参阅QWidget::setLayout().

[虚拟 noexcept] QGridLayout::~QGridLayout()

如果这是顶级网格，则终止几何管理。

布局的控件不会被销毁。

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::addItem(QLayoutItem *item)

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

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

将布局layout放在网格的row，（i translate="no">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，（i translate="no">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().

[重写虚函数] int QGridLayout::count() const

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

[重写虚函数] 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().

[覆盖虚函数] bool QGridLayout::hasHeightForWidth() const

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

[覆盖虚函数] int QGridLayout::heightForWidth(int w) const

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

[覆盖虚函数] void QGridLayout::invalidate()

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

[覆盖虚函数] QLayoutItem *QGridLayout::itemAt(int index) const

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

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

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

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

[覆盖虚函数] QSize QGridLayout::maximumSize() const

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

[覆盖虚函数] int QGridLayout::minimumHeightForWidth(int w) const

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

[覆盖虚函数] 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。

[重写虚函数] 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。

[重写虚函数] void QGridLayout::setSpacing(int spacing)

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

此函数将垂直和水平间隔都设置为spacing。

另请参阅：spacing、setVerticalSpacing 和 setHorizontalSpacing。

[重写虚函数] QSize QGridLayout::sizeHint() const

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

[重写虚函数] int QGridLayout::spacing() const

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

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

另请参阅setSpacing()，verticalSpacing() 和 horizontalSpacing。

[重写虚函数] QLayoutItem *QGridLayout::takeAt(int index)

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