桌面应用 / 系统课时

把自定义控件放进 Designer

把自定义控件放进 Designer

本篇解决 Qt Designer 无法直接识别业务自定义控件的问题。通过 Promote Widgets 功能,可以把已有的 QWidget 子类接入可视化设计流程,让界面布局和自定义逻辑保持分离。

学习目标

  • 理解 Qt Designer 中提升控件的作用和适用场景
  • 掌握将自定义 QWidget 注册到 Designer 界面的操作流程
  • 学会验证提升后的控件是否正确加载

为什么需要提升自定义控件

Qt Designer 默认只能展示 Qt 内置控件,例如 QPushButton、QLabel 和 QLineEdit。当项目中出现继承自 QWidget 的业务控件时,Designer 不知道这个类的存在,也无法直接拖入界面。

Promote Widgets 提供了一种桥接方式:先在 Designer 中放置一个普通基类控件,再指定它实际对应的自定义类。生成代码时,Qt 会按照提升后的类型创建对象。

例如,一个自定义绘图控件继承自 QWidget:

cpp
#include <QWidget>

class ColorPreview : public QWidget
{
public:
    explicit ColorPreview(QWidget *parent = nullptr);
};

Designer 中可以先放置 QWidget,然后将它提升为 ColorPreview。

使用 Promote Widgets 接入控件

提升控件时,需要准备三个信息:基类控件、自定义类名和头文件路径。

操作流程如下:

  1. 在 Designer 中拖入与自定义控件继承关系匹配的基础控件。
  2. 右键控件,选择提升为(Promote to)。
  3. 填写自定义类名称,例如 ColorPreview。
  4. 填写对应头文件,例如 colorpreview.h。
  5. 添加后应用提升设置。

如果一个项目中多个窗口使用相同控件,可以复用相同的提升配置。

检查生成代码是否正确

保存 .ui 文件后,Qt 的代码生成工具会把界面转换为 C++ 初始化代码。提升成功后,生成代码中会包含自定义头文件,并创建对应类型对象。

例如生成结果中可能包含:

cpp
#include "colorpreview.h"

void setupUi(QWidget *widget)
{
    ColorPreview *preview = new ColorPreview(widget);
}

预期结果

text
界面初始化代码可以找到 ColorPreview 类型,并在运行时创建自定义控件对象。

如果仍然生成 QWidget,通常说明提升设置没有保存,或者类名、头文件路径填写错误。

使用时的常见问题

自定义控件必须满足 Qt 对象系统要求。如果控件需要信号槽、属性编辑或运行时类型识别,应继承 QObject 体系并使用 Q_OBJECT 宏。

另外,提升控件解决的是 Designer 识别问题,并不会自动让 Designer 显示控件的真实绘制效果。需要预览效果时,应额外实现 Qt Designer 插件。

对于普通业务控件,Promote Widgets 已经足够;对于需要拖放体验、属性面板和实时预览的复杂控件,则应考虑开发 Designer 插件。

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

目录与阅读设置

阅读设置

17

记录一个想法

把自定义控件放进 Designer

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

登录哪都通