
在先前的文章中,学习了 QVBoxLayout、QHBoxLayout、QGridLayout 3 个布局类,今天来学习 QFormLayout,这是一个专门用于表单布局的布局类。
前言
QFormLayout 就是 Qt 专门为“标签 + 输入控件”这种两列表单场景封装的布局管理器,不用手动管理行列,自带标签关联、跨平台对齐规则、自适应换行能力,非常适合做各类工具的参数配置面板。
QFormLayout 固定是多行两列结构:
- 左列:标签(QLabel),用来描述参数名称
- 右列:字段控件(QLineEdit / QSpinBox / QComboBox / QCheckBox 等输入组件)
以下是一个用户登录表单示例:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
| import sys
from PySide6.QtWidgets import QApplication, QWidget, QFormLayout, QLineEdit, QHBoxLayout, QPushButton
class MyWindow(QWidget):
def __init__(self):
super().__init__()
self.setWindowTitle("登录表单")
form_layout = QFormLayout()
self.edt_name = QLineEdit()
form_layout.addRow("用户名", self.edt_name)
self.edt_password = QLineEdit()
self.edt_password.setEchoMode(QLineEdit.EchoMode.Password)
form_layout.addRow("密码", self.edt_password)
btn_layout = QHBoxLayout()
btn_login = QPushButton("登录")
btn_reset = QPushButton("重置")
btn_layout.addWidget(btn_login)
btn_layout.addWidget(btn_reset)
form_layout.addRow(btn_layout)
self.setLayout(form_layout)
btn_reset.clicked.connect(self.on_reset)
btn_login.clicked.connect(lambda: print(f"用户名:{self.edt_name.text()},密码:{self.edt_password.text()}"))
def on_reset(self):
self.edt_name.clear()
self.edt_password.clear()
self.edt_name.setFocus()
app = QApplication(sys.argv)
window = MyWindow()
window.show()
sys.exit(app.exec())
|
演示效果如下:

核心 API
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
| import sys
from PySide6.QtCore import Qt
from PySide6.QtWidgets import (
QApplication, QWidget, QFormLayout, QLineEdit,
QSpinBox, QComboBox
)
class FormApiDemo(QWidget):
def __init__(self):
super().__init__()
self.setWindowTitle("QFormLayout 核心API演示")
self.resize(450, 260)
form = QFormLayout(self)
form.setLabelAlignment(Qt.AlignmentFlag.AlignRight)
form.setFormAlignment(Qt.AlignmentFlag.AlignTop | Qt.AlignmentFlag.AlignLeft)
form.setHorizontalSpacing(12)
form.setVerticalSpacing(24)
form.setFieldGrowthPolicy(QFormLayout.FieldGrowthPolicy.ExpandingFieldsGrow)
# form.setRowWrapPolicy(QFormLayout.RowWrapPolicy.WrapAllRows)
form.addRow("名称", QLineEdit("demo"))
form.addRow("数量", QSpinBox())
cb = QComboBox()
cb.addItems(["选项A", "选项B", "选项C"])
form.addRow("类型", cb)
app = QApplication(sys.argv)
window = FormApiDemo()
window.show()
sys.exit(app.exec())
|
演示效果如下:

QFormLayout 除了 addRow 方法,还有其他核心 API 方法,用于设置标签对齐、字段宽度、换行策略等:
setLabelAlignment 方法:设置标签对齐方式setFormAlignment 方法:设置表单对齐方式setHorizontalSpacing 方法:设置水平间距setVerticalSpacing 方法:设置垂直间距setFieldGrowthPolicy 方法:设置字段宽度增长策略setRowWrapPolicy 方法:设置换行策略