在……中创建主窗口Qt Widgets Designer
Qt Widgets Designer 可用于创建用于不同目的的用户界面,并为每种用户界面提供不同类型的表单模板。主窗口模板用于创建带有菜单栏、工具栏和停靠控件的应用程序窗口。
通过打开“文件”菜单并选择“新建表单...”选项,或按Ctrl+N 键,可创建一个新的主窗口。然后,选择“主窗口”模板。该模板默认提供一个包含菜单栏和工具栏的主应用程序窗口——如果不需要,可以将其删除。
如果移除了菜单栏,可以通过在主窗口表单内右键单击以打开上下文菜单,然后选择“创建菜单栏”选项来创建一个新的菜单栏。
一个应用程序只能有一个菜单栏,但可以有多个工具栏。
菜单
通过修改“在此处输入”占位符,可以将菜单添加到菜单栏中。其中一个占位符始终用于编辑,不会在预览或最终生成的窗口中显示。
创建后,可通过“属性编辑器”访问菜单的属性,并可通过“对象检查器”访问每个菜单以进行此操作。
要删除现有菜单,请在菜单栏中的标签上打开上下文菜单,然后选择“删除菜单‘menu_name’”。

创建菜单
双击占位符项以开始编辑。菜单文本通过行编辑框显示,可以进行修改。
输入新菜单所需的文本。输入“&”符号后,紧随其后的字母将被用作该菜单的助记符。
按Return或Enter键接受新文本,或按Escape 键拒绝。如有需要,您稍后可以撤销此编辑操作。
您还可以通过在菜单栏中将菜单拖拽到所需位置来重新排列菜单。一条垂直的红线表示该菜单将被插入的位置。
菜单可以包含任意数量的条目和分隔符,并可按需要进行多级嵌套。通过常规方式浏览菜单结构,即可向菜单中添加新条目。

创建菜单条目
双击“在此输入”占位符开始编辑,或双击“添加分隔符”在菜单的最后一个条目后插入新的分隔线。
菜单项的文本通过行编辑框显示,并且可以进行修改。
输入新条目的所需文本,可选地使用“&”符号来标记作为该条目助记符的字母。
按Return或Enter键接受新文本,或按Escape 键拒绝。为此菜单项创建的操作可通过“操作编辑器”访问,并可在其中设置任何相关的键盘快捷键。
与菜单一样,只需将菜单项拖拽到所需位置即可轻松调整其位置。当菜单项被拖拽到已关闭的菜单上时,该菜单会自动打开,以便将其插入其中。由于菜单项基于动作,因此也可以将其拖拽到工具栏上,届时它们将作为工具栏按钮显示。
工具栏

创建和删除工具栏
向主窗口添加工具栏的方法与添加菜单栏类似:从表单的上下文菜单中选择“添加工具栏”选项。此外,如果主窗口中已有工具栏,您可以单击其右端的箭头来创建新的工具栏。
通过工具栏右键菜单中的相应选项,即可从表单中删除工具栏。
添加和删除工具栏按钮
工具栏按钮是在“操作编辑器”中作为操作创建的,然后拖放到工具栏上。由于操作既可以以菜单项的形式呈现,也可以以工具栏按钮的形式呈现,因此可以在菜单和工具栏之间进行移动。

若要在菜单和工具栏之间共享一个动作,请将其图标从“动作编辑器”拖动到工具栏,而不是从包含该条目的菜单中拖动。有关此过程的更多信息,请参阅“添加动作”。
可通过工具栏的右键菜单删除工具栏按钮。
操作
在菜单栏和工具栏就位后,接下来需要为它们添加操作。菜单和工具栏的新操作均在“操作编辑器”窗口中创建,这简化了操作的创建和管理。

操作编辑器
打开“工具”菜单,启用“操作编辑器”选项,即可激活操作编辑器。
操作编辑器允许您创建“新建操作”和“删除操作”。它还提供了一项基于操作文本的搜索功能——“筛选”。
Qt Widgets Designer的操作编辑器可在经典的图标视图和 详细视图中查看。下图展示了详细视图中的操作编辑器。您还可以在菜单、工具栏和表单之间复制和粘贴操作。
创建操作
要创建操作,请使用操作编辑器中的“新建”按钮,这将弹出一个输入对话框。为新操作提供一个“文本”——这是将显示在菜单项中以及作为操作工具提示的文本。该文本还会自动添加到“action”前缀之后,从而生成操作的“对象名称”。
此外,该对话框还提供了为操作选择图标的选项,以及移除当前图标的选项。
创建动作后,即可在所有适用动作的场景中使用它。

添加操作
要将操作添加到菜单或工具栏中,只需在操作编辑器中点击该操作并按住鼠标左键,然后将其拖动到目标位置即可。
Qt Widgets Designer 系统会显示高亮的引导线,提示您操作将被添加的位置。找到合适的位置后,松开鼠标按钮即可添加该操作。
停靠小部件
停靠控件也是容器控件。可以通过将其拖放到所需的停靠区域中,将其添加到表单中。

添加 Dock 小部件
要将停靠控件添加到表单中,请从小部件框的“容器”部分拖动一个控件,并将其拖放到主表单区域。请勿将停靠控件添加到现有布局中。相反,应打开“属性编辑器”,启用“停靠”属性,将其放置在停靠区域中。
请注意,在将布局应用到中心小部件之前,先将停靠小部件添加到表单中,有时会更便于配置该小部件。例如,您可以将其取消停靠并调整大小,从而更方便地添加子小部件。
停靠控件可选地作为独立的工具窗口浮动显示。因此,通过设置其windowTitle 属性为其指定窗口标题非常有用。这也有助于在表单上识别它们。
© 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.