如何在QML中添加C++ QQuickPaintedItem类（qmake构建）

1. 补全C++类实现 #

仅头文件无法完成编译，需创建notchedrectangle.cpp实现文件：

#include "notchedrectangle.hpp"
#include <QPainter>

NotchedRectangle::NotchedRectangle() : m_color(Qt::red) {}

void NotchedRectangle::paint(QPainter* painter) {
    painter->setBrush(m_color);
    painter->drawRect(boundingRect());
    // 此处添加缺口绘制逻辑
}

QColor NotchedRectangle::color() const {
    return m_color;
}

void NotchedRectangle::setColor(QColor color) {
    if (m_color != color) {
        m_color = color;
        emit colorChanged();
        update(); // 触发重绘
    }
}

2. 修正qmake配置 #

修改项目.pro文件，添加必要配置：

# 引入Qt Quick与QML模块
QT += qml quick

# 启用QML类型生成
CONFIG += qmltypes

# 定义QML导入命名空间与版本
QML_IMPORT_NAME = UI.NR
QML_IMPORT_MAJOR_VERSION = 1

# 添加源文件与头文件路径
SOURCES += \
    main.cpp \
    UI/NotchedRectangle/notchedrectangle.cpp

HEADERS += \
    UI/NotchedRectangle/notchedrectangle.hpp

# 添加头文件搜索路径（确保编译时能找到头文件）
INCLUDEPATH += $$PWD/UI/NotchedRectangle

3. 排查错误根源 #

你遇到的[Makefile.Debug:1175: qlauncher_metatypes.json] Error 1错误，通常由以下原因导致：

• 缺少类实现文件：仅添加头文件未添加对应的.cpp文件，无法生成元类型信息
• Qt版本过低：QML_ELEMENT需Qt 5.15或Qt 6及以上版本，确认你的Qt版本符合要求
• 命名空间冲突：QML_IMPORT_NAME与已有导入冲突，可尝试修改为更独特的名称（如CustomUI.NotchedRectangle）
• 编译缓存问题：删除build目录下所有文件，重新执行qmake与构建

4. QML中使用示例 #

构建成功后，即可在QML中导入并使用该组件：

import UI.NR 1.0

NotchedRectangle {
    color: "blue"
    width: 200
    height: 100
}

内容的提问来源于stack exchange，提问作者SlimRG