QFormLayout Class

成员函数文档

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

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

该布局将直接设置为parent 的顶级布局。一个控件只能有一个顶级布局。该布局由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 ，其text属性设置为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)

将指定的layout 插入到此表单布局的row 位置。layout 横跨两列。如果row 超出范围，则该控件将添加在末尾。

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

将指定的widget 插入到此表单布局的row 位置。widget 横跨两列。如果row 超出范围，则将小部件添加到末尾。

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() 的值将减一。该行中所有小部件及嵌套布局均被删除，包括字段小部件和标签（如有）。后续所有行将向上移动一行，腾出的垂直空间将在剩余行中重新分配。

您可以使用此函数撤销之前的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() 的计数将减一。该行中所有小部件及嵌套布局均被删除，包括字段小部件和标签（如有）。后续所有行均向上移动一行，释放出的垂直空间将在剩余行之间重新分配。

您可以使用此函数撤销之前的 `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() 的计数将减一。该行中所有小部件及嵌套布局均被删除，包括字段小部件以及（如有）标签。后续所有行均向上移动一行，腾出的垂直空间将在剩余行之间重新分配。

您可以使用此函数撤销之前的 `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 为真，则显示与layout 对应的行；否则隐藏该行。

该函数在 Qt 6.4 中引入。

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

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

如果on 为真，则显示与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)

将指定role 对应的、位于给定row 中的控件设置为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() 的值将减一。随后的所有行将向上移动一行，而腾出的垂直空间将在剩余行之间重新分配。

您可以使用此函数撤销之前的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() 的值将减一。后续所有行将向上移动一行，而腾出的垂直空间将在剩余行之间重新分配。

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