本页内容

Qt Widgets Designer的小部件编辑模式

显示 Qt Widgets Designer 编辑模式的屏幕截图,用于更改布局中组件的大小或位置

在控件编辑模式下,可以将对象从主窗口的控件框拖动到表单上,进行编辑、调整大小、在表单上拖动,甚至在不同表单之间拖动。对象属性可以交互式修改,因此更改效果会立即显示。 该编辑界面对于简单操作而言直观易用,同时仍支持 Qt 强大的布局功能。

要创建和编辑新表单,请打开“文件”菜单并选择“新建表单...”或按Ctrl+N。要编辑现有表单,可从“文件”菜单中选择“打开表单...”或按Ctrl+O。

在任何时候,您都可以通过从“文件”菜单中选择“另存为...”选项来保存表单。由Qt Widgets Designer 保存的UI文件包含所用对象的相关信息,以及它们之间信号与槽连接的详细信息。

编辑表单

默认情况下,新表单会以控件编辑模式打开。若要从其他模式切换到编辑模式,请从“编辑”菜单中选择“编辑控件”,或按F3键。

将对象从主控件框中拖拽到表单上的目标位置,即可将其添加到表单中。添加后,可以通过拖拽或使用方向键轻松移动这些对象。 同时按住Ctrl键可将选中的控件逐像素移动,而仅使用方向键移动时,选中的控件会吸附到网格上。点击对象的左键即可选中它们。您也可以使用Tab键来切换选中对象。

控件框中包含多个不同类别的对象,所有这些对象均可根据需要放置在表单上。唯一需要稍作准备的是容器控件。关于这些控件的详细说明,请参阅“在Qt Widgets Designer 中使用容器”一章。

显示在 Qt Widgets Designer 编辑器模式下被选中的小部件的屏幕截图选择对象

通过用鼠标左键单击表单上的对象即可将其选中。选中对象后,其每个角和每条边的中点处会显示调整大小控点,表明该对象可以调整大小。

要选择其他对象,请按住Control键并单击它们。如果选中了多个对象,当前对象将显示为不同颜色的调整大小控点。

要在布局中移动控件,请按住Shift和Control 键的同时拖动该控件。这会将选择范围扩展到该控件的父布局。

此外,还可以在“对象检查器”中选择对象。

选中控件后,可对其执行剪切、复制和粘贴等常规剪贴板操作。所有这些操作均可根据需要执行或撤销。

可以使用以下快捷键:

操作快捷键说明
剪切Ctrl+X将选中的对象剪切到剪贴板。
复制Ctrl+C将选中的对象复制到剪贴板。
粘贴Ctrl+V将剪贴板中的对象粘贴到表单上。
删除删除删除所选对象。
克隆对象Ctrl+拖动(鼠标左键)复制所选对象或对象组。
预览Ctrl+R显示表单的预览。

除“克隆”外,上述所有操作均可通过“编辑”菜单和表单的右键菜单访问。这些菜单还提供了用于排列对象的功能,以及“全选”功能,用于选中表单上的所有对象。

控件并非唯一的对象;您可以根据需要复制任意数量的控件。要快速复制控件,可以按住Ctrl键并拖动它进行克隆。与使用剪贴板操作相比,这种方式能够更快速地将控件复制并放置到表单上。

截图展示了 UI 编辑器中的控件,这些控件可以通过拖放自由移动拖放

Qt Widgets Designer 广泛利用了 Qt 提供的拖放功能。Qt Widgets 可以从 Widgets 库中拖出并放到表单上。

小部件还可以在表单上“克隆”:按住Ctrl 键并拖动小部件,即可创建该小部件的副本,然后将其拖动到新位置。

此外,还可以将控件拖放到“对象检查器”中,以便轻松处理嵌套布局。

Qt Widgets Designer 该功能允许在表单之间复制、粘贴和拖动所选对象。您可以利用此功能创建同一表单的多个副本,并在每个副本中尝试不同的布局。

属性编辑器

属性编辑器始终显示表单上当前选中对象的属性。可用的属性取决于正在编辑的对象,但所有提供的控件都具有一些共同属性,例如objectName (对象的内部名称)和enabled (该属性决定对象是否可交互)。

截图展示了小部件的属性编辑器,其中提供了可自由调整小部件的各项选项编辑属性

属性编辑器使用标准的 Qt Widgets 来管理表单上对象的属性。文本属性显示在行编辑框中,整数属性显示在旋转框中,布尔属性显示在复选框中,而颜色和尺寸等复合属性则显示在输入控件的下拉列表中。

已修改的属性会以粗体标签标示。若要将其重置,请点击右侧的箭头按钮。

属性更改将应用于所有具有相同属性的已选对象。

属性编辑器会对某些属性进行特殊处理:

  • 复合属性(由多个值组成的属性)以可展开的节点形式显示,便于编辑其值。
  • 包含选项或可选标志的属性,可通过带有可选项目的下拉列表框进行编辑。
  • 允许访问丰富数据类型的属性(例如QPalette ),可通过编辑属性时弹出的对话框进行修改。QLabel 以及控件框中“按钮”部分的控件均具有text 属性,该属性可通过双击控件或按F2键进行编辑。Qt Widgets Designer 对反斜杠 (\) 字符进行特殊解释,从而允许将换行符 (\n) 插入文本中;字符序列 \\ 用于在文本中插入单个反斜杠。编辑时还可以打开上下文菜单,这为向文本中插入特殊字符和换行符提供了另一种方式。

动态属性

属性编辑器还可用于为标准 Qt Widgets 和表单本身添加新的dynamic properties 。自 Qt 4.4 起,可通过属性编辑器的工具栏(如下图所示)添加和删除动态属性。

显示某个小部件属性编辑器工具栏的屏幕截图

要添加动态属性,请单击“添加”按钮“添加”按钮 。要删除动态属性,请单击“删除”按钮“删除”按钮 。您还可以通过单击“配置”按钮“配置”按钮 ,按字母顺序对属性进行排序,并更改颜色组。

对象检查器

显示布局中所有控件对象树的屏幕截图对象检查器

“对象检查器”会显示当前正在编辑的表单上所有对象的分层列表。要显示容器控件或布局的子对象,请单击对象标签旁边的拉手。

通过在“对象检查器”中单击相应项目,即可选中表单上的每个对象。右键单击可打开表单的上下文菜单。如果表单上有许多重叠的对象,这些功能会非常有用。要在“对象检查器”中查找某个对象,请使用Ctrl+F。

自 Qt 4.4 起,双击对象名称即可使用就地编辑器更改对象名称。

从 Qt 4.5 开始,“对象检查器”会显示容器的布局状态。如果布局出现问题,将显示一个破损的布局图标 ###ICON。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.