QFormLayout 类

成员函数文档

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

使用指定的parent小部件构建一个新的表单布局。

布局直接设置为parent的顶层布局。一个小部件只能有一个顶层布局。它由QWidget::layout()返回。

另请参阅QWidget::setLayout。

[虚析构 InvalidOperationException] QFormLayout::~QFormLayout()

销毁表单布局。

[重写虚拟] void QFormLayout::addItem(QLayoutItem *item)

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

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

将带有给定label和field的新行添加到表单布局的底部。

另请参阅insertRow。

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

这是一个重载函数。

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

这是一个重载函数。

此重载函数将在幕后自动创建一个带有文本 labelText 的 QLabel。将 field 设置为新的 QLabel 的 buddy。

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

这是一个重载函数。

此重载函数将在幕后自动创建一个带有文本 labelText 的 QLabel。

void QFormLayout::addRow(QWidget *widget)

这是一个重载函数。

将指定的 widget 添加到表单布局的末尾。该 widget 将跨越两列。

void QFormLayout::addRow(QLayout *layout)

这是一个重载函数。

将指定的 layout 添加到表单布局的末尾。该 layout 将跨越两列。

[继承虚拟] int QFormLayout::count() const

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

[继承虚拟] 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。

[覆盖虚拟] bool QFormLayout::hasHeightForWidth() const

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

[覆盖虚拟] 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, QWidget *label, QLayout *field)

这是一个重载函数。

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

这是一个重载函数。

此重载函数将在幕后自动创建一个带有文本 labelText 的 QLabel。将 field 设置为新的 QLabel 的 buddy。

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

这是一个重载函数。

此重载函数将在幕后自动创建一个带有文本 labelText 的 QLabel。

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

这是一个重载函数。

在此表单布局中插入指定 widget，位置为 row。该 widget 扩展到两个列。如果 row 超出范围，则控件添加到末尾。

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

这是一个重载函数。

在此表单布局中插入指定 layout，位置为 row。该 layout 扩展到两个列。如果 row 超出范围，则控件添加到末尾。

[覆盖虚拟] void QFormLayout::invalidate()

重新实现：QLayout::invalidate。

[自 6.4 版本以来] bool QFormLayout::isRowVisible(int row) const

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

此函数是在 Qt 6.4 中引入的。

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

这是一个重载函数。

如果与widget对应的行中的一些条目是可见的，则返回 true，否则返回 false。

此函数是在 Qt 6.4 中引入的。

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

这是一个重载函数。

如果与layout对应的行中的一些条目是可见的，则返回 true，否则返回 false。

此函数是在 Qt 6.4 中引入的。

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

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

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

[重写虚函数] QLayoutItem *QFormLayout::itemAt(int index) const

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

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

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

另请参阅itemAt()。

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

这是一个重载函数。

[重写虚函数] QSize QFormLayout::minimumSize() const

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

void QFormLayout::removeRow(int row)

从此表单布局中删除行row。

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

在此调用后，rowCount()减一。此行占用的所有小部件和嵌套布局都将被删除。这包括字段小部件（s）和标签（如果有的话）。所有后续行都将上移一行，释放的垂直空间将在剩余行之间重新分配。

您可以使用此函数撤消之前的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(QWidget *widget)

这是一个重载函数。

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

在此调用后，rowCount()减一。此行占用的所有小部件和嵌套布局都将被删除。这包括字段小部件（s）和标签（如果有的话）。所有后续行都将上移一行，释放的垂直空间将在剩余行之间重新分配。

您可以使用此函数撤消之前的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()。

void QFormLayout::removeRow(QLayout *layout)

这是一个重载函数。

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

在此调用后，rowCount()减一。此行占用的所有小部件和嵌套布局都将被删除。这包括字段小部件（s）和标签（如果有的话）。所有后续行都将上移一行，释放的垂直空间将在剩余行之间重新分配。

您可以使用此函数撤消之前的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()。

int QFormLayout::rowCount() const

返回表单中的行数。

另请参阅QLayout::count().

[重写虚函数] 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为true，则显示行row，否则隐藏该行。

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

此函数是在 Qt 6.4 中引入的。

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

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

这是一个重载函数。

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

此函数是在 Qt 6.4 中引入的。

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

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

这是一个重载函数。

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

此函数是在 Qt 6.4 中引入的。

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

[覆盖虚函数] 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 并且向控制台发送错误消息。

注意：对于大多数应用程序，最好使用 addRow() 或 insertRow() 而不是 setWidget()。

另请参阅setLayout().

[覆盖虚函数] QSize QFormLayout::sizeHint() const

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

[覆盖虚函数] int QFormLayout::spacing() const

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

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

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

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

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()。