QFormLayout Class

成员函数文档

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

使用给定的parent widget 构建一个新的表单布局。

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

另请参阅 QWidget::setLayout()。

[virtual noexcept] QFormLayout::~QFormLayout()

销毁表格布局。

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

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

void QFormLayout::addRow(QWidget *label, QWidget *field)

在此表单布局的底部添加新的一行，行号为label 和field 。

另请参见 insertRow()。

void QFormLayout::addRow(QLayout *layout)

这是一个重载函数。

在此表单布局的末尾添加指定的layout 。layout 跨两列。

void QFormLayout::addRow(QWidget *widget)

这是一个重载函数。

在此表单布局的末尾添加指定的widget 。widget 跨两列。

void QFormLayout::addRow(QWidget *label, QLayout *field)

这是一个重载函数。

void QFormLayout::addRow(const QString &labelText, QLayout *field)

这是一个重载函数。

该重载函数会在后台自动创建一个QLabel ，文本为labelText 。

void QFormLayout::addRow(const QString &labelText, QWidget *field)

这是一个重载函数。

该重载会在后台自动创建一个QLabel ，其文本为labelText 。field 将被设置为新的QLabel 的buddy 。

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

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

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

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

void QFormLayout::getItemPosition(int index, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

读取指定index 项目的行和角色（列）。如果index 越界，则 *rowPtr 设置为-1；否则，行存储在 *rowPtr 中，角色存储在 *rolePtr 中。

另请参阅 itemAt(),count(),getLayoutPosition() 和getWidgetPosition() 。

void QFormLayout::getLayoutPosition(QLayout *layout, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

读取指定子layout 的行和角色（列）。如果layout 不在表单布局中，则 *rowPtr 设置为-1；否则，行存储在 *rowPtr 中，角色存储在 *rolePtr 中。

void QFormLayout::getWidgetPosition(QWidget *widget, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

读取布局中指定widget 的行和角色（列）。如果widget 不在布局中，*rowPtr 将被设置为-1；否则，行存储在 *rowPtr 中，角色存储在 *rolePtr 中。

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

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

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

[override virtual] int QFormLayout::heightForWidth(int width) const

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

void QFormLayout::insertRow(int row, QWidget *label, QWidget *field)

在此表格布局中的row 位置插入新行，给定的label 和field 。如果row 越界，则在末尾添加新行。

另请参见 addRow()。

void QFormLayout::insertRow(int row, QLayout *layout)

这是一个重载函数。

在此表单布局的row 位置插入指定的layout 。layout 跨两列。如果row 越界，则在末尾添加 widget。

void QFormLayout::insertRow(int row, QWidget *widget)

这是一个重载函数。

在此表单布局的row 位置插入指定的widget 。widget 跨两列。如果row 越界，则在末尾添加 widget。

void QFormLayout::insertRow(int row, QWidget *label, QLayout *field)

这是一个重载函数。

void QFormLayout::insertRow(int row, const QString &labelText, QLayout *field)

这是一个重载函数。

该重载函数会在后台自动创建一个QLabel ，文本为labelText 。

void QFormLayout::insertRow(int row, const QString &labelText, QWidget *field)

这是一个重载函数。

该重载会在后台自动创建一个QLabel ，其文本为labelText 。field 将被设置为新的QLabel 的buddy 。

[override virtual] void QFormLayout::invalidate()

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

[since 6.4] bool QFormLayout::isRowVisible(int row) const

如果行row 中的某些项目可见，则返回 true，否则返回 false。

此函数在 Qt 6.4 中引入。

[since 6.4] bool QFormLayout::isRowVisible(QLayout *layout) const

这是一个重载函数。

如果layout 所对应行中的某些项目可见，则返回 true，否则返回 false。

此函数在 Qt 6.4 中引入。

[since 6.4] bool QFormLayout::isRowVisible(QWidget *widget) const

这是一个重载函数。

如果widget 所对应行中的某些项目可见，则返回 true，否则返回 false。

此函数在 Qt 6.4 中引入。

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

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

QLayoutItem *QFormLayout::itemAt(int row, QFormLayout::ItemRole role) const

返回row 中指定role （列）的布局项。如果没有布局项，则返回nullptr 。

另请参阅 QLayout::itemAt() 和setItem()。

QWidget *QFormLayout::labelForField(QWidget *field) const

返回与给定field 相关的标签。

另请参阅 itemAt() 。

QWidget *QFormLayout::labelForField(QLayout *field) const

这是一个重载函数。

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

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

void QFormLayout::removeRow(int row)

从表格布局中删除行row 。

row 必须为非负数，且小于 ()。rowCount

调用后，rowCount() 将递减 1。占用该行的所有部件和嵌套布局都将被删除。这包括字段部件和标签（如果有）。所有后续行将上移一行，腾出的垂直空间将重新分配给其余各行。

您可以使用该函数撤销之前的addRow() 或insertRow()：

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
flay->removeRow(2); // le == nullptr at this point

如果想在不删除部件的情况下从布局中删除行，请使用takeRow() 代替。

另请参见 takeRow()。

void QFormLayout::removeRow(QLayout *layout)

这是一个重载函数。

从表单布局中删除与layout 对应的行。

调用后，rowCount() 将递减 1。占用该行的所有部件和嵌套布局都将被删除。这包括字段部件和标签（如果有）。所有后续行将上移一行，腾出的垂直空间将重新分配给其余各行。

您可以使用该函数撤销之前的addRow() 或insertRow()：

QFormLayout *flay = ...;
QPointer<QVBoxLayout> vbl = new QVBoxLayout;
flay->insertRow(2, "User:", vbl);
// later:
flay->removeRow(layout); // vbl == nullptr at this point

如果要从表单布局中删除行而不删除插入的布局，请使用takeRow() 代替。

另请参见 takeRow()。

void QFormLayout::removeRow(QWidget *widget)

这是一个重载函数。

从表单布局中删除与widget 对应的行。

调用后，rowCount() 将递减 1。占用该行的所有部件和嵌套布局都将被删除。这包括字段部件和标签（如果有）。所有后续行将上移一行，腾出的垂直空间将重新分配给其余各行。

您可以使用该函数撤销之前的addRow() 或insertRow()：

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
flay->removeRow(le); // le == nullptr at this point

如果想在不删除部件的情况下从布局中删除行，请使用takeRow() 代替。

另请参见 takeRow()。

int QFormLayout::rowCount() const

返回表格的行数。

另请参阅 QLayout::count()。

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

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

void QFormLayout::setItem(int row, QFormLayout::ItemRole role, QLayoutItem *item)

将给定row 中的项目设置为给定role 的item ，必要时用空行扩展布局。

如果单元格已被占用，则不会插入item ，并向控制台发送错误信息。item 跨两列。

另请参阅 setLayout()。

void QFormLayout::setLayout(int row, QFormLayout::ItemRole role, QLayout *layout)

将row 中给定role 的子布局设置为layout ，必要时用空行扩展表单布局。

如果单元格已被占用，则不会插入layout ，并向控制台发送错误信息。

注：对于大多数应用程序，应使用addRow() 或insertRow() 代替 setLayout()。

另请参阅 setWidget()。

[since 6.4] void QFormLayout::setRowVisible(int row, bool on)

如果on 为真，则显示行row ，否则隐藏该行。

row 必须是非负值，且小于 ()。rowCount

此函数在 Qt 6.4 中引入。

另请参阅 isRowVisible()、removeRow() 和takeRow()。

[since 6.4] void QFormLayout::setRowVisible(QLayout *layout, bool on)

这是一个重载函数。

如果on 为 true，则显示与layout 对应的行，否则隐藏该行。

此函数在 Qt 6.4 中引入。

另请参阅 removeRow() 和takeRow()。

[since 6.4] void QFormLayout::setRowVisible(QWidget *widget, bool on)

这是一个重载函数。

如果on 为 true，则显示与widget 对应的行，否则隐藏该行。

此函数在 Qt 6.4 中引入。

另请参阅 removeRow() 和takeRow()。

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

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

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

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

void QFormLayout::setWidget(int row, QFormLayout::ItemRole role, QWidget *widget)

将row 中给定role 的 widget 设置为widget ，必要时用空行扩展布局。

如果单元格已被占用，则不会插入widget ，并向控制台发送错误信息。

注：对于大多数应用程序，应使用addRow() 或insertRow() 代替 setWidget()。

另请参阅 setLayout()。

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

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

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

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

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

另请参见 setSpacing()、verticalSpacing() 和horizontalSpacing()。

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

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

QFormLayout::TakeRowResult QFormLayout::takeRow(int row)

从该表格布局中删除指定的row 。

row 必须为非负数且小于 ().rowCount

调用此函数后，rowCount() 将递减 1。所有后续行将上移一行，腾出的垂直空间将重新分配给其余各行。

您可以使用该函数撤销之前的addRow() 或insertRow()：

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(2);

如果想从布局中移除该行并删除部件，请使用removeRow() 代替。

返回 包含部件和相应标签布局项的结构

另请参见 removeRow()。

QFormLayout::TakeRowResult QFormLayout::takeRow(QLayout *layout)

这是一个重载函数。

从该表单布局中删除指定的layout 。

调用此函数后，rowCount() 将递减 1。所有后续行将上移一行，腾出的垂直空间将重新分配给其余各行。

QFormLayout *flay = ...;
QPointer<QVBoxLayout> vbl = new QVBoxLayout;
flay->insertRow(2, "User:", vbl);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(widget);

如果要从表单布局中移除该行并删除插入的布局，请使用removeRow() 代替。

返回包含部件和相应标签布局项的结构

另请参见 removeRow()。

QFormLayout::TakeRowResult QFormLayout::takeRow(QWidget *widget)

这是一个重载函数。

从该表单布局中删除指定的widget 。

调用此函数后，rowCount() 将递减 1。所有后续行将上移一行，腾出的垂直空间将重新分配给其余各行。

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(widget);

如果想从布局中删除该行并删除部件，请使用removeRow() 代替。

返回包含部件和相应标签布局项的结构

另请参见 removeRow()。