桌面应用 / 系统课时

用 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 文档上下文:

xml
<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++ 代码则专注于读取控件状态、连接信号槽和实现业务行为。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Designer 设计窗口界面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通