桌面应用 / 系统课时
用 Designer 设计窗口界面
用 Designer 设计窗口界面
Qt Designer 适合把控件摆放、布局和常用属性从 C++ 代码中分离出来。本节完成一个简单表单界面:拖入控件、设置稳定的对象名、应用布局,并保存为 .ui 文件,使它能够继续被 Qt 工程加载和生成界面代码。
学习目标
- 使用 Designer 放置控件并通过布局管理器组织窗口结构。
- 为需要在代码中访问的控件设置清晰且稳定的
objectName。 - 保存并检查
.ui文件,确认布局和关键属性已经正确写入。
先搭出界面结构
在 Designer 中新建基于 QWidget 的窗体后,可以拖入两个 QLabel、两个 QLineEdit 和一个 QPushButton,组成“姓名、邮箱、保存”表单。此时不要依靠手工坐标完成最终排版,而应尽快应用布局。
布局管理器负责根据窗口尺寸重新计算控件的位置和大小。表单型界面可以使用 QFormLayout,更自由的二维排列可以使用 QGridLayout。如果只拖放控件而不设置布局,窗口缩放后常会出现大片空白、控件重叠或边距不一致。
设置可维护的对象名
Designer 会自动生成类似 lineEdit、lineEdit_2 的对象名,但这些名称很难表达用途。对于后续需要在 C++ 中访问的控件,应在 Property Editor 中修改 objectName,例如 nameEdit、emailEdit 和 saveButton。
对象名是代码识别控件的重要标识,而按钮显示的“保存”属于 text 属性,两者用途不同。修改界面文案时通常只改 text,不要随意改动已经被代码引用的 objectName。
保存并检查 ui 文件
将窗体保存为 profileform.ui。.ui 文件本质上是 XML,Designer 会把控件类型、对象名、属性和布局关系写入其中。通常不需要手工编辑 XML,但查看它可以帮助确认关键设置是否真正保存。
下面是与本节表单结构对应的片段示例,依赖 Designer 生成的完整 .ui 文档上下文:
<widget class="QWidget" name="ProfileForm">
<layout class="QFormLayout" name="formLayout">
<item row="0" column="1">
<widget class="QLineEdit" name="nameEdit"/>
</item>
<item row="1" column="1">
<widget class="QLineEdit" name="emailEdit"/>
</item>
<item row="2" column="1">
<widget class="QPushButton" name="saveButton">
<property name="text">
<string>保存</string>
</property>
</widget>
</item>
</layout>
</widget>生效行为与验证方法:重新在 Designer 中打开 profileform.ui,应能看到输入框和按钮仍位于同一布局中;在 Object Inspector 中应能找到 nameEdit、emailEdit 和 saveButton,按钮文字保持为“保存”。
用预览检查布局
保存前应使用 Designer 的窗体预览功能检查界面,而不只看编辑状态。重点观察窗口放大和缩小时控件是否随布局调整、标签与输入框是否保持对应关系,以及按钮是否出现异常拉伸。
如果预览时控件位置完全固定,通常说明顶层窗体还没有应用布局;如果某个控件无法按预期扩展,则继续检查它所在布局以及 sizePolicy。先在 Designer 中把结构问题解决,再进入 C++ 代码处理业务逻辑,可以减少大量手工调整尺寸和坐标的代码。
一个适合交给工程加载的 .ui 文件,应具备明确的顶层布局、稳定的关键对象名以及经过预览验证的缩放行为。Designer 负责描述界面结构,后续 C++ 代码则专注于读取控件状态、连接信号槽和实现业务行为。