桌面应用 / 系统课时
把自定义控件放进 Designer
把自定义控件放进 Designer
本篇解决 Qt Designer 无法直接识别业务自定义控件的问题。通过 Promote Widgets 功能,可以把已有的 QWidget 子类接入可视化设计流程,让界面布局和自定义逻辑保持分离。
学习目标
- 理解 Qt Designer 中提升控件的作用和适用场景
- 掌握将自定义 QWidget 注册到 Designer 界面的操作流程
- 学会验证提升后的控件是否正确加载
为什么需要提升自定义控件
Qt Designer 默认只能展示 Qt 内置控件,例如 QPushButton、QLabel 和 QLineEdit。当项目中出现继承自 QWidget 的业务控件时,Designer 不知道这个类的存在,也无法直接拖入界面。
Promote Widgets 提供了一种桥接方式:先在 Designer 中放置一个普通基类控件,再指定它实际对应的自定义类。生成代码时,Qt 会按照提升后的类型创建对象。
例如,一个自定义绘图控件继承自 QWidget:
#include <QWidget>
class ColorPreview : public QWidget
{
public:
explicit ColorPreview(QWidget *parent = nullptr);
};Designer 中可以先放置 QWidget,然后将它提升为 ColorPreview。
使用 Promote Widgets 接入控件
提升控件时,需要准备三个信息:基类控件、自定义类名和头文件路径。
操作流程如下:
- 在 Designer 中拖入与自定义控件继承关系匹配的基础控件。
- 右键控件,选择提升为(Promote to)。
- 填写自定义类名称,例如 ColorPreview。
- 填写对应头文件,例如 colorpreview.h。
- 添加后应用提升设置。
如果一个项目中多个窗口使用相同控件,可以复用相同的提升配置。
检查生成代码是否正确
保存 .ui 文件后,Qt 的代码生成工具会把界面转换为 C++ 初始化代码。提升成功后,生成代码中会包含自定义头文件,并创建对应类型对象。
例如生成结果中可能包含:
#include "colorpreview.h"
void setupUi(QWidget *widget)
{
ColorPreview *preview = new ColorPreview(widget);
}预期结果
界面初始化代码可以找到 ColorPreview 类型,并在运行时创建自定义控件对象。如果仍然生成 QWidget,通常说明提升设置没有保存,或者类名、头文件路径填写错误。
使用时的常见问题
自定义控件必须满足 Qt 对象系统要求。如果控件需要信号槽、属性编辑或运行时类型识别,应继承 QObject 体系并使用 Q_OBJECT 宏。
另外,提升控件解决的是 Designer 识别问题,并不会自动让 Designer 显示控件的真实绘制效果。需要预览效果时,应额外实现 Qt Designer 插件。
对于普通业务控件,Promote Widgets 已经足够;对于需要拖放体验、属性面板和实时预览的复杂控件,则应考虑开发 Designer 插件。