qmlRegisterType和setContextProperty的差別

qmlRegisterType 和 setContextProperty 都是將 C++ 類或對象暴露給 QML 的兩種方法，但它們的用途、行為和適用情境有所不同。以下是這兩者的差別：

1. qmlRegisterType

qmlRegisterType 是用來將 C++ 類註冊為 QML 可使用的類型，讓 QML 可以直接創建該類型的實例並使用它。這通常用於將 C++ 類暴露給 QML，以便在 QML 中創建對象並使用該類的功能。

主要特點：

• 註冊 C++ 類型：qmlRegisterType 會將一個 C++ 類註冊到 QML 引擎中，這樣 QML 就能直接使用這個類。
• 允許 QML 創建對象：這樣，QML 就能夠像使用原生 QML 控件一樣，創建並操作 C++ 類的對象。
• 需要指定類型名稱：在註冊類型時，你會指定 QML 中將使用的類型名稱，這樣在 QML 中創建實例時就可以使用這個名稱。
• 支持自訂 C++ 類行為：如果需要在 QML 中創建和使用 C++ 類的對象，可以使用這個方法。通常它是將 C++ 類作為控件、模型、視圖或處理邏輯的對象暴露給 QML。

範例：

#include <QQuickView>
#include <QQmlEngine>
#include <QQmlContext>
#include <QtQml>

class MyClass : public QObject {
    Q_OBJECT
public:
    MyClass(QObject *parent = nullptr) : QObject(parent) {}
    Q_INVOKABLE void sayHello() {
        qDebug() << "Hello from C++!";
    }
};

// 在 main.cpp 中註冊類型
int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);

    // 註冊 C++ 類型到 QML
    qmlRegisterType<MyClass>("com.example", 1, 0, "MyClass");

    // 創建 QML 視圖
    QQuickView view;
    view.setSource(QUrl(QStringLiteral("qrc:/main.qml")));
    view.show();

    return app.exec();
}

在這個範例中，我們使用 qmlRegisterType 註冊了 MyClass 類，使得 QML 可以創建這個類型的實例並在 QML 中使用它。

2. setContextProperty

setContextProperty 用來將 C++ 對象或變數作為上下文屬性傳遞給 QML。這樣，QML 可以訪問 C++ 中的對象或變數，但它不會創建這些對象，而是讓 QML 能夠引用和使用已經存在的 C++ 對象。

主要特點：

• 設置上下文屬性：setContextProperty 是將現有的 C++ 對象或變數暴露給 QML，作為 QML 上下文的一部分，讓 QML 可以訪問它們。
• 不需要註冊 C++ 類型：它不需要註冊類型，直接將現有的對象（如 C++ 類的實例）傳遞給 QML。
• 適用於共享現有對象：適用於需要在 QML 中共享 C++ 對象的情況。例如，當你有一個已經存在的 C++ 對象，並希望將其提供給 QML 進行操作時，可以使用 setContextProperty。
• 沒有類型註冊的限制：不需要對 C++ 類進行註冊，對象可以是任何 C++ 類的實例。

範例：

#include <QQuickView>
#include <QQmlEngine>
#include <QQmlContext>
#include <QtQml>

class MyClass : public QObject {
    Q_OBJECT
public:
    MyClass(QObject *parent = nullptr) : QObject(parent) {}
    Q_INVOKABLE void sayHello() {
        qDebug() << "Hello from C++!";
    }
};

// 在 main.cpp 中使用 setContextProperty
int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);

    // 創建 MyClass 實例
    MyClass myObject;

    // 創建 QML 視圖
    QQuickView view;

    // 設置 C++ 對象為 QML 上下文屬性
    view.engine()->rootContext()->setContextProperty("myObject", &myObject);

    // 設置 QML 源文件
    view.setSource(QUrl(QStringLiteral("qrc:/main.qml")));
    view.show();

    return app.exec();
}

在這個範例中，我們通過 setContextProperty 將 myObject（MyClass 的實例）設置為 QML 上下文的屬性，並讓 QML 中的代碼能夠訪問該對象。

主要區別總結：

特性	qmlRegisterType	setContextProperty
作用	註冊 C++ 類型，讓 QML 能夠創建該類的實例	將已存在的 C++ 對象或變數暴露給 QML
用途	讓 QML 創建和使用 C++ 類型的對象	讓 QML 引用和操作已經創建的 C++ 對象
註冊類型	需要註冊 C++ 類型	不需要註冊類型
對象創建	QML 可以創建 C++ 類型的實例	QML 無法創建對象，只能引用 C++ 類型的實例
適用情境	當需要在 QML 中創建 C++ 類型的實例時使用	當需要在 QML 中共享現有 C++ 對象時使用

總結：

• qmlRegisterType 用於將 C++ 類型註冊到 QML，並使 QML 可以創建該類的實例。這適合於當你希望在 QML 中創建新的 C++ 對象並使用其功能時。
• setContextProperty 用於將現有的 C++ 對象或變數傳遞給 QML，讓 QML 直接引用這些對象。這適合於當你已經有一個 C++ 對象，並希望將它暴露給 QML 使用的情況。