QFormLayout管理输入型控件和关联的标签组成的那些Form表单。
QFormLayout是1个方便的布局类,其中的控件以两列的情势被布局在表单中。左列包括标签,右列包括输入控件,例如:QLineEdit、QSpinBox等。
我们可以通过addRow(const QString &labelText, QWidget *field)来创建1个带有给定文本的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 | 标签有足够的空间适应,如果最小大小比可用空间大,输入框会被换到下1行 | |
QFormLayout::WrapAllRows | 2 | 输入框始终在标签下边 |
setWidget(int row, ItemRole role, QWidget *widget)
设置行row所对应的控件,如果role为LabelRole时,设置的为标签所对应的控件,如果role为FieldRole时,设置的为输入框所对应的控件。
QFormLayout::ItemRole枚举:
指定1排控件的类型
内容 | 值 | 描写 |
---|---|---|
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);
setVerticalSpacing(int spacing)
设置间距(水平间距、垂直间距)
QWidget * QFormLayout::labelForField(QWidget * field)
通过field获得field对应的标签,这里不1定是QLabel,返回值为QWidget。
当要设计的界面是1种类似于两列和若干行组成的情势时,使用QFormLayout(表单布局)要比QGridLayout(栅格布局)更加方便些。
当界面元素较为复杂时(多行多列),应绝不犹豫的尽可能使用栅格布局,而不是使用水平和垂直布局的组合或嵌套的情势,由于在多数情况下,后者常常会使“局势”更加复杂而难以控制。栅格布局赋予了界面设计器更大的自由度来排列组合界面元素,而仅仅带来了微小的复杂度开消。