Qt之表单布局（QFormLayout）

简述

QFormLayout管理输入型控件和关联的标签组成的那些Form表单。

QFormLayout是一个方便的布局类，其中的控件以两列的形式被布局在表单中。左列包括标签，右列包含输入控件，例如：QLineEdit、QSpinBox等。

• 简述
• 使用
• 常用接口
• 总结

使用

我们可以通过addRow(const QString &labelText, QWidget *field)来创建一个带有给定文本的QLabel及QWidget控件行，它们可以自动的设置为伙伴关系。

QFormLayout *pLayout = new QFormLayout();
pLayout->addRow(QStringLiteral("用户名："), pUserLineEdit);
pLayout->addRow(QStringLiteral("密码："), pPasswordLineEdit);
pLayout->addRow(QStringLiteral("验证码："), pVerifyLineEdit);
pLayout->setSpacing(10);
pLayout->setMargin(10);
setLayout(pLayout);

使用QGridLayout格栅布局编写的比较：

QLabel *pUserNameLabel = new QLabel(this);
QLabel *pPasswordLabel = new QLabel(this);
QLabel *pVerifyLabel = new QLabel(this);

pUserNameLabel->setText(QStringLiteral("用户名："));
pPasswordLabel->setText(QStringLiteral("密码："));
pVerifyLabel->setText(QStringLiteral("验证码："));

QGridLayout *pLayout = new QGridLayout();
pLayout->addWidget(pUserNameLabel, 0, 0);
pLayout->addWidget(pUserLineEdit, 0, 1);
pLayout->addWidget(pPasswordLabel, 1, 0);
pLayout->addWidget(pPasswordLineEdit, 1, 1);
pLayout->addWidget(pVerifyLabel, 2, 0);
pLayout->addWidget(pVerifyLineEdit, 2, 1);
pLayout->setSpacing(10);
pLayout->setMargin(10);
setLayout(pLayout);

很显然，功能可以实现，但是代码量大了很多。

常用接口

• setRowWrapPolicy(RowWrapPolicy policy)

  设置换行策略

QFormLayout::RowWrapPolicy枚举：

控制表单行的显示策略。

内容	值	描述	效果
QFormLayout::DontWrapRows	0	输入框始终在标签旁边
QFormLayout::WrapLongRows	1	标签有足够的空间适应，如果最小大小比可用空间大，输入框会被换到下一行
QFormLayout::WrapAllRows	2	输入框始终在标签下边

---

• setWidget(int row, ItemRole role, QWidget *widget)

  设置行row所对应的控件，如果role为LabelRole时，设置的为标签所对应的控件，如果role为FieldRole时，设置的为输入框所对应的控件。

QFormLayout::ItemRole枚举：

指定一排控件的类型

内容	值	描述
QFormLayout::LabelRole	0	标签
QFormLayout::FieldRole	1	输入框
QFormLayout::SpanningRole	2	跨越标签和输入框的控件

例如：

//pLayout->addRow(pUserNameLabel, pUserLineEdit);
pLayout->setWidget(0, QFormLayout::LabelRole, pUserNameLabel);
pLayout->setWidget(0, QFormLayout::FieldRole, pUserLineEdit);

---

• setSpacing(int spacing)
• setHorizontalSpacing(int spacing)

• setVerticalSpacing(int spacing)

  设置间距（水平间距、垂直间距）

---

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

  通过field获取field对应的标签，这里不一定是QLabel，返回值为QWidget。

总结

当要设计的界面是一种类似于两列和若干行组成的形式时，使用QFormLayout（表单布局）要比QGridLayout（栅格布局）更为方便些。

当界面元素较为复杂时（多行多列），应毫不犹豫的尽量使用栅格布局，而不是使用水平和垂直布局的组合或者嵌套的形式，因为在多数情况下，后者往往会使“局势”更加复杂而难以控制。栅格布局赋予了界面设计器更大的自由度来排列组合界面元素，而仅仅带来了微小的复杂度开销。