Класс QQmlEngine

QQmlEngine engine;
QQmlComponent component(&engine);
component.setData("import QtQuick 2.0\nText { text: \"Hello world!\" }", QUrl());
QQuickItem *item = qobject_cast<QQuickItem *>(component.create());

//add item to view, etc
...

class MySingleton : public QObject {
  Q_OBJECT

  // Register as default constructed singleton.
  QML_ELEMENT
  QML_SINGLETON

  static int typeId;
  // ...
};

MySingleton::typeId = qmlTypeId(...);

// Retrieve as QObject*
QQmlEngine engine;
MySingleton* instance = engine.singletonInstance<MySingleton*>(MySingleton::typeId);

// Register with QJSValue callback
int typeId = qmlRegisterSingletonType(...);

// Retrieve as QJSValue
QQmlEngine engine;
QJSValue instance = engine.singletonInstance<QJSValue>(typeId);

Связанные не члены

template <typename T> QObject *qmlAttachedPropertiesObject(const QObject *attachee, bool create = true)

Форма этой шаблонной функции:

template<typename T> QObject *qmlAttachedPropertiesObject(const QObject *attachee, bool create = true)

Это возвращает экземпляр присоединенного объекта, который был присоединен к указанному attachee типом присоединения T.

Если create имеет значение true, а тип T является допустимым типом присоединения, это создает и возвращает новый экземпляр присоединенного объекта.

Возвращает 0, если тип T не является допустимым типом присоединения или если create имеет значение false, и ранее не был создан экземпляр присоединенного объекта для attachee.

См. также QML_ATTACHED() и Предоставление присоединенных свойств.

void qmlClearTypeRegistrations()

Очищает все сохраненные регистрации типов, такие как те, что созданы с помощью qmlRegisterType().

Не вызывайте эту функцию, когда существует QQmlEngine, иначе поведение будет неопределенным. Все существующие QQmlEngines должны быть удалены перед вызовом этой функции. Эта функция затрагивает только глобальный кеш приложения. Удалите QQmlEngine для очистки всех кэшированных данных, относящихся к этому движку.

QQmlContext *qmlContext(const QObject *object)

Возвращает QQmlContext, связанный с object, если таковой имеется. Это эквивалентно QQmlEngine::contextForObject(object).

Примечание: Добавьте #include <QtQml> для использования этой функции.

См. также contextForObject() и qmlEngine().

QQmlEngine *qmlEngine(const QObject *object)

Возвращает QQmlEngine, связанный с object, если таковой имеется. Это эквивалентно QQmlEngine::contextForObject(object)->engine(), но более эффективно.

Примечание: Добавьте #include <QtQml> для использования этой функции.

См. также contextForObject() и qmlContext().

bool qmlProtectModule(const char *uri, int majVersion)

Эта функция защищает модуль от регистрации типов в нем. Это может использоваться для предотвращения вставки типов другими плагинами в ваш модуль. Это также может улучшить производительность, поскольку позволяет движку пропустить проверку на возможность новых типов или плагинов при достижении этого импорта.

Преимущество в производительности проявляется главным образом при регистрации типов, специфичных для приложения, внутри приложения, а не через плагин. Использование qmlProtectModule позволяет движку пропустить проверку плагина при импорте этого uri, что может быть заметно при медленных файловых системах.

После вызова этой функции любая попытка зарегистрировать типы C++ в этой комбинации uri и версии приведет к ошибке во время выполнения. Вызовите эту функцию после регистрации всех ваших типов в движке.

Возвращает true, если был найден и заблокирован модуль с uri в качестве идентификатора модуля и majVersion в качестве номера основной версии; в противном случае возвращает false. Модуль должен содержать экспортируемые типы, чтобы быть найденным.

template <typename T> int qmlRegisterAnonymousType(const char *uri, int versionMajor)

Эта шаблонная функция регистрирует тип C++ в системе QML как анонимный тип. Результирующий тип QML не имеет имени. Поэтому экземпляры этого типа не могут быть созданы из системы QML. Однако вы можете получить доступ к экземплярам типа, когда они экспонированы как свойства других типов.

Используйте эту функцию, когда тип не будет ссылаться по имени, особенно для типов C++, используемых в левой части привязки свойств. Для указания модуля, к которому принадлежит тип, используйте uri и versionMajor.

Например, рассмотрим следующие два класса:

class Bar : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString baz READ baz WRITE setBaz NOTIFY bazChanged)

public:
    Bar() {}

    QString baz() const { return mBaz; }

    void setBaz(const QString &baz)
    {
        if (baz == mBaz)
            return;

        mBaz = baz;
        emit bazChanged();
    }

signals:
    void bazChanged();

private:
    QString mBaz;
};

class Foo : public QObject
{
    Q_OBJECT
    Q_PROPERTY(Bar *bar READ bar CONSTANT FINAL)

public:
    Foo() {}

    Bar *bar() { return &mBar; }

private:
    Bar mBar;
};

В QML мы присваиваем строку свойству baz объекта bar:

Foo {
    bar.baz: "abc"
    Component.onCompleted: print(bar.baz)
}

Чтобы движок QML знал, что тип Bar имеет свойство baz, мы должны сделать тип Bar известным:

qmlRegisterType<Foo>("App", 1, 0, "Foo");
qmlRegisterAnonymousType<Bar>("App", 1);

Поскольку тип Foo инициализируется в QML, его необходимо зарегистрировать с помощью версии qmlRegisterType(), которая принимает имя элемента.

Возвращает идентификатор типа QML.

Эта функция была введена в Qt 5.14.

См. также QML_ANONYMOUS и Выбор правильного метода интеграции между C++ и QML.

template <typename T, typename E> int qmlRegisterExtendedType(const char *uri, int versionMajor, int versionMinor, const char *qmlName)

Эта шаблонная функция регистрирует тип C++ и его расширение в системе QML с именем qmlName в библиотеке, импортированной из uri, имеющей номер версии, составленный из versionMajor и versionMinor. Свойства, отсутствующие в основном типе, будут искаться в объекте расширения.

Возвращает идентификатор типа QML.

См. также QML_EXTENDED(), qmlRegisterType() и Регистрация объектов расширения.

template <typename T, typename E> int qmlRegisterExtendedUncreatableType(const char *uri, int versionMajor, int versionMinor, const char *qmlName, const QString &reason)

Эта шаблонная функция регистрирует тип C++ и его расширение в системе QML с именем qmlName в библиотеке, импортированной из uri, имеющей номер версии, составленный из versionMajor и versionMinor.

Хотя у типа есть имя и тип, его нельзя создать. Если пользователь попытается создать экземпляр этого типа, будет выведено сообщение об ошибке с заданным reason.

Это полезно в случаях, когда тип предназначен только для предоставления присоединенных свойств, значений перечислений или абстрактного базового класса с его расширением.

Возвращает идентификатор типа QML.

См. также QML_EXTENDED(), QML_UNCREATABLE() и qmlRegisterUncreatableType().

template <typename T> int qmlRegisterInterface(const char *typeName)

Эта шаблонная функция регистрирует тип C++ в системе QML под именем typeName.

Типы, зарегистрированные как интерфейсы в движке, также должны объявлять себя как интерфейсы с системой метаобъектов. Например:

struct FooInterface
{
public:
    virtual ~FooInterface();
    virtual void doSomething() = 0;
};

Q_DECLARE_INTERFACE(FooInterface, "org.foo.FooInterface")

При регистрации в движке QML таким образом, они могут использоваться как типы свойств:

Q_PROPERTY(FooInterface *foo READ foo WRITE setFoo)

При присвоении подклассу QObject этому свойству, движок QML автоматически выполняет приведение интерфейса к типу FooInterface*.

Возвращает идентификатор типа QML.

См. также QML_INTERFACE.

void qmlRegisterModule(const char *uri, int versionMajor, int versionMinor)

Эта функция регистрирует модуль в определенном uri с указанной версией в versionMajor и versionMinor.

Это может использоваться для предоставления определенной версии модуля, даже если для этой версии не зарегистрированы типы. Это особенно полезно для синхронизации версий связанных модулей.

Эта функция была введена в Qt 5.9.

template <typename T, int metaObjectRevision> int qmlRegisterRevision(const char *uri, int versionMajor, int versionMinor)

Эта шаблонная функция регистрирует указанную версию типа C++ в системе QML с библиотекой, импортированной из uri, имеющей номер версии, составленный из versionMajor и versionMinor.

Возвращает идентификатор типа QML.

template<typename T, int metaObjectRevision>
int qmlRegisterRevision(const char *uri, int versionMajor, int versionMinor);

Эта функция обычно используется для регистрации ревизии базового класса для использования с указанной версией типа (см. Ревизии и версии типов).

int qmlRegisterSingletonInstance(const char *uri, int versionMajor, int versionMinor, const char *typeName, QObject *cppObject)

Эта функция используется для регистрации одиночного объекта cppObject с определенным uri и typeName. Его версия является комбинацией versionMajor и versionMinor.

Установка типа одиночки в URI позволяет предоставить произвольную функциональность (методы и свойства) коду QML без необходимости создания отдельных экземпляров типа клиентом.

Используйте эту функцию для регистрации объекта заданного типа T как типа одиночки.

Синглтон-тип QObject может быть указан по имени типа, с помощью которого он был зарегистрирован; в свою очередь, это имя типа может быть использовано в качестве целевого типа в подключении или как любой другой идентификатор типа. Однако есть одно исключение: свойство синглтон-типа QObject не может быть переименовано, так как имя синглтон-типа не идентифицирует объект в рамках того же компонента, что и любой другой элемент.

Примечание: cppObject должен существовать дольше, чем движок QML, в котором он используется. Кроме того, cppObject должен иметь ту же аффинити-связь с потоком, что и движок. Если вам нужны отдельные синглтон-экземпляры для нескольких движков, необходимо использовать qmlRegisterSingletonType. Для получения дополнительной информации о потоковой безопасности см. Потоки и QObjects.

Использование:

// First, define your QObject which provides the functionality.
class SingletonTypeExample : public QObject
{
    Q_OBJECT
    Q_PROPERTY(int someProperty READ someProperty WRITE setSomeProperty NOTIFY somePropertyChanged)

public:
    explicit SingletonTypeExample(QObject* parent = nullptr) : QObject(parent) {}

    Q_INVOKABLE int doSomething()
    {
        setSomeProperty(5);
        return m_someProperty;
    }

    int someProperty() const { return m_someProperty; }
    void setSomeProperty(int val) {
        if (m_someProperty != val) {
            m_someProperty = val;
            emit somePropertyChanged(val);
        }
    }

signals:
    void somePropertyChanged(int newValue);

private:
    int m_someProperty = 0;
};

// Second, create an instance of the object

// allocate example before the engine to ensure that it outlives it
QScopedPointer<SingletonTypeExample> example(new SingletonTypeExample);
QQmlEngine engine;

// Third, register the singleton type provider with QML by calling this
// function in an initialization function.
qmlRegisterSingletonInstance("Qt.example.qobjectSingleton", 1, 0, "MyApi", example.get());

Для использования зарегистрированного синглтон-типа в QML необходимо импортировать URI с соответствующей версией.

import QtQuick 2.0
import Qt.example.qobjectSingleton 1.0
Item {
    id: root
    property int someValue: MyApi.someProperty

    Component.onCompleted: {
        console.log(MyApi.doSomething())
    }
}

Данная функция была добавлена в Qt 5.14.

См. также QML_SINGLETON и qmlRegisterSingletonType.

int qmlRegisterSingletonType(const char *uri, int versionMajor, int versionMinor, const char *typeName, QJSValue (*)(QQmlEngine *, QJSEngine *) callback)

Данная функция может быть использована для регистрации поставщика синглтон-типа callback в определённом uri и typeName с версией, указанной в versionMajor и versionMinor.

Установка синглтон-типа позволяет разработчикам предоставлять произвольные функции (методы и свойства) клиенту без необходимости создания отдельных экземпляров типа клиентом.

Синглтон-тип может быть либо QObject, либо QJSValue. Данная функция предназначена для регистрации функции поставщика синглтон-типа, которая возвращает QJSValue как синглтон-тип.

ПРИМЕЧАНИЕ: Свойства синглтон-типа QJSValue не будут вызывать повторную оценку привязки при изменении.

Использование:

// First, define the singleton type provider function (callback).
static QJSValue example_qjsvalue_singletontype_provider(QQmlEngine *engine, QJSEngine *scriptEngine)
{
    Q_UNUSED(engine)

    static int seedValue = 5;
    QJSValue example = scriptEngine->newObject();
    example.setProperty("someProperty", seedValue++);
    return example;
}

// Second, register the singleton type provider with QML by calling this function in an initialization function.
qmlRegisterSingletonType("Qt.example.qjsvalueApi", 1, 0, "MyApi", example_qjsvalue_singletontype_provider);

Альтернативно, можно использовать лямбда-выражение C++11:

qmlRegisterSingletonType("Qt.example.qjsvalueApi", 1, 0, "MyApi", [](QQmlEngine *engine, QJSEngine *scriptEngine) -> QJSValue {
    Q_UNUSED(engine)

    static int seedValue = 5;
    QJSValue example = scriptEngine->newObject();
    example.setProperty("someProperty", seedValue++);
    return example;
});

Для использования зарегистрированного синглтон-типа в QML необходимо импортировать синглтон-тип.

import QtQuick 2.0
import Qt.example.qjsvalueApi 1.0 as ExampleApi
Item {
    id: root
    property int someValue: ExampleApi.MyApi.someProperty
}

См. также QML_SINGLETON и Выбор правильного метода интеграции между C++ и QML.

template <typename T> int qmlRegisterSingletonType(const char *uri, int versionMajor, int versionMinor, const char *typeName, QObject *(*)(QQmlEngine *, QJSEngine *) callback)

Данная функция может быть использована для регистрации поставщика синглтон-типа callback в определённом uri и typeName с версией, указанной в versionMajor и versionMinor.

Установка синглтон-типа в URI позволяет разработчикам предоставлять произвольные функции (методы и свойства) клиентам без необходимости создания отдельных экземпляров типа клиентом.

Синглтон-тип может быть либо QObject, либо QJSValue. Данная функция предназначена для регистрации функции поставщика синглтон-типа, которая возвращает QObject заданного типа T как синглтон-тип.

Синглтон-тип QObject может быть указан по имени типа, с помощью которого он был зарегистрирован, и это имя типа может быть использовано в качестве целевого типа в подключении или как любой другой идентификатор типа. Единственное исключение состоит в том, что свойство синглтон-типа QObject не может быть переименовано.

ПРИМЕЧАНИЕ: Экземпляр синглтон-типа QObject, возвращаемый поставщиком синглтон-типа, принадлежит движку QML, если объект не имеет явного флага QQmlEngine::CppOwnership.

Использование:

// First, define your QObject which provides the functionality.
class SingletonTypeExample : public QObject
{
    Q_OBJECT
    Q_PROPERTY (int someProperty READ someProperty WRITE setSomeProperty NOTIFY somePropertyChanged)

public:
    SingletonTypeExample(QObject* parent = 0)
        : QObject(parent), m_someProperty(0)
    {
    }

    ~SingletonTypeExample() {}

    Q_INVOKABLE int doSomething() { setSomeProperty(5); return m_someProperty; }

    int someProperty() const { return m_someProperty; }
    void setSomeProperty(int val) { m_someProperty = val; emit somePropertyChanged(val); }

signals:
    void somePropertyChanged(int newValue);

private:
    int m_someProperty;
};

// Second, define the singleton type provider function (callback).
static QObject *example_qobject_singletontype_provider(QQmlEngine *engine, QJSEngine *scriptEngine)
{
    Q_UNUSED(engine)
    Q_UNUSED(scriptEngine)

    SingletonTypeExample *example = new SingletonTypeExample();
    return example;
}

// Third, register the singleton type provider with QML by calling this function in an initialization function.
qmlRegisterSingletonType<SingletonTypeExample>("Qt.example.qobjectSingleton", 1, 0, "MyApi", example_qobject_singletontype_provider);

Альтернативно, можно использовать лямбда-выражение C++11:

qmlRegisterSingletonType<SingletonTypeExample>("Qt.example.qobjectSingleton", 1, 0, "MyApi", [](QQmlEngine *engine, QJSEngine *scriptEngine) -> QObject * {
    Q_UNUSED(engine)
    Q_UNUSED(scriptEngine)

    SingletonTypeExample *example = new SingletonTypeExample();
    return example;
});

Для использования зарегистрированного синглтон-типа в QML необходимо импортировать синглтон-тип.

import QtQuick 2.0
import Qt.example.qobjectSingleton 1.0
Item {
    id: root
    property int someValue: MyApi.someProperty

    Component.onCompleted: {
        someValue = MyApi.doSomething()
    }
}

См. также QML_SINGLETON и Выбор правильного метода интеграции между C++ и QML.

template <typename T> int qmlRegisterSingletonType(const char *uri, int versionMajor, int versionMinor, const char *typeName, std::function<QObject *(QQmlEngine *, QJSEngine *)> callback)

Данная функция перегружает qmlRegisterSingletonType.

Данная функция была добавлена в Qt 5.14.

int qmlRegisterSingletonType(const QUrl &url, const char *uri, int versionMajor, int versionMinor, const char *qmlName)

Данная функция может быть использована для регистрации синглтон-типа с именем qmlName в библиотеке, импортируемой из uri с номером версии, состоящим из versionMajor и versionMinor. Тип определяется файлом QML, расположенным по адресу url. URI должен быть абсолютным, т.е. url.isRelative() == false.

Кроме того, файл QML типа должен иметь среди своих инструкций импорта псевдоним Singleton.

Синглтон-тип может быть указан по имени типа, с помощью которого он был зарегистрирован, и это имя типа может быть использовано в качестве целевого типа в подключении или как любой другой идентификатор типа. Одно исключение из этого правила состоит в том, что свойство синглтон-типа не может быть переименовано (потому что имя синглтон-типа не идентифицирует объект в рамках того же компонента, что и любой другой элемент).

Использование:

// First, define your QML singleton type which provides the functionality.
pragma Singleton
import QtQuick 2.0
Item {
    property int testProp1: 125
}

// Second, register the QML singleton type by calling this function in an initialization function.
qmlRegisterSingletonType(QUrl("file:///absolute/path/SingletonType.qml"), "Qt.example.qobjectSingleton", 1, 0, "RegisteredSingleton");

Для использования зарегистрированного синглтон-типа в QML необходимо импортировать синглтон-тип.

import QtQuick 2.0
import Qt.example.qobjectSingleton 1.0
Item {
    id: root
    property int someValue: RegisteredSingleton.testProp1
}

Также возможно регистрация QML-синглтон-типов без использования функции qmlRegisterSingletonType. Это можно сделать, добавив в файл QML типа среди инструкций импорта псевдоним Singleton. Кроме того, тип должен быть определён в файле qmldir со словом singleton, а qmldir должен быть импортирован файлами QML, использующими синглтон.

См. также QML_SINGLETON.

template <typename T> int qmlRegisterType(const char *uri, int versionMajor, int versionMinor, const char *qmlName)

Эта шаблонная функция регистрирует тип C++ в системе QML с именем qmlName в библиотеке, импортированной из uri с номером версии, состоящим из versionMajor и versionMinor.

Возвращает идентификатор QML-типа.

Существуют две формы этой шаблонной функции:

template<typename T>
int qmlRegisterType(const char *uri, int versionMajor, int versionMinor, const char *qmlName);

template<typename T, int metaObjectRevision>
int qmlRegisterType(const char *uri, int versionMajor, int versionMinor, const char *qmlName);

Первая — это стандартная форма, которая регистрирует тип T как новый тип. Вторая позволяет зарегистрировать определённую редакцию класса в указанной версии (см. Редакции и версии типов).

Например, это регистрирует класс C++ MySliderItem как QML-тип под именем Slider для версии 1.0 пространства имён типа "com.mycompany.qmlcomponents":

qmlRegisterType<MySliderItem>("com.mycompany.qmlcomponents", 1, 0, "Slider");

После регистрации этот тип можно использовать в QML, импортировав указанное пространство имён типа и номер версии:

import com.mycompany.qmlcomponents 1.0

Slider {
    // ...
}

Обратите внимание, что для библиотеки вполне приемлемо регистрировать типы для более ранних версий, чем фактическая версия библиотеки. Действительно, обычно новая библиотека позволяет QML, написанному для предыдущих версий, продолжать работать, даже если доступны более продвинутые версии некоторых её типов.

См. также QML_ELEMENT, QML_NAMED_ELEMENT() и Выбор правильного метода интеграции между C++ и QML.

int qmlRegisterType(const QUrl &url, const char *uri, int versionMajor, int versionMinor, const char *qmlName)

Данная функция регистрирует тип в системе QML с именем qmlName в библиотеке, импортируемой из uri с номером версии, состоящим из versionMajor и versionMinor. Тип определяется файлом QML, расположенным по адресу url. URI должен быть абсолютным, т.е. url.isRelative() == false.

Обычно файлы QML могут загружаться как типы непосредственно из других файлов QML или с помощью файла qmldir. Данная функция позволяет регистрировать файлы в типы из кода C++, например, когда соответствие типов необходимо определять процедурно при запуске.

Возвращает -1, если регистрация не удалась.

int qmlRegisterTypeNotAvailable(const char *uri, int versionMajor, int versionMinor, const char *qmlName, const QString &message)

Эта функция регистрирует тип в системе QML с именем qmlName в пространстве имён типа, импортированном из uri, имеющем номер версии, составленный из versionMajor и versionMinor, но любая попытка создать экземпляр типа вызовет указанную ошибку message.

Обычно типы, экспортируемые плагином, должны быть фиксированными. Однако, если тип C++ недоступен, вы должны хотя бы «зарезервировать» имя QML типа и предоставить пользователю недоступного типа понятное сообщение об ошибке.

Возвращает идентификатор QML типа.

Пример:

#ifdef NO_GAMES_ALLOWED
qmlRegisterTypeNotAvailable("MinehuntCore", 0, 1, "Game", "Get back to work, slacker!");
#else
qmlRegisterType<MinehuntGame>("MinehuntCore", 0, 1, "Game");
#endif

Это приведет к тому, что любой QML, который импортирует пространство имен типа «MinehuntCore» и пытается использовать тип, выведет сообщение об ошибке:

fun.qml: Get back to work, slacker!
   Game {
   ^

Без этого было бы выведено общее сообщение «Игра не является типом».

См. также QML_UNAVAILABLE, qmlRegisterUncreatableType() и Выбор правильного метода интеграции между C++ и QML.

int qmlRegisterUncreatableMetaObject(const QMetaObject &staticMetaObject, const char *uri, int versionMajor, int versionMinor, const char *qmlName, const QString &reason)

Эта функция регистрирует staticMetaObject и её расширение в системе QML с именем qmlName в библиотеке, импортированной из uri, имеющей номер версии, составленный из versionMajor и versionMinor.

Экземпляр метаобъекта создать нельзя. При попытке его создания будет выведено сообщение об ошибке с заданным сообщением reason.

Эта функция полезна для регистрации пространств имён Q_NAMESPACE.

Возвращает идентификатор QML типа.

Например:

namespace MyNamespace {
  Q_NAMESPACE
  enum MyEnum {
      Key1,
      Key2,
  };
  Q_ENUMS(MyEnum)
}

//...
qmlRegisterUncreatableMetaObject(MyNamespace::staticMetaObject, "io.qt", 1, 0, "MyNamespace", "Access to enums & flags only");

На стороне QML теперь можно использовать зарегистрированные перечисления:

Component.onCompleted: console.log(MyNamespace.Key2)

Эта функция была добавлена в Qt 5.8.

См. также QML_ELEMENT, QML_NAMED_ELEMENT() и QML_UNCREATABLE().

template <typename T> int qmlRegisterUncreatableType(const char *uri, int versionMajor, int versionMinor, const char *qmlName, const QString &message)

Эта шаблонная функция регистрирует тип C++ в системе QML с именем qmlName в библиотеке, импортированной из uri, имеющей номер версии, составленный из versionMajor и versionMinor.

Хотя тип имеет имя и тип, он не может быть создан, и при попытке создания будет отображено заданное сообщение об ошибке message.

Это полезно в случаях, когда тип предназначен только для предоставления присоединённых свойств или значений перечислений.

Возвращает идентификатор QML типа.

См. также QML_UNCREATABLE(), qmlRegisterTypeNotAvailable() и Выбор правильного метода интеграции между C++ и QML.

int qmlTypeId(const char *uri, int versionMajor, int versionMinor, const char *qmlName)

Возвращает идентификатор QML типа, который был зарегистрирован с именем qmlName в определённом uri и версии, указанной в versionMajor и versionMinor.

Эта функция возвращает то же значение, что и функции регистрации QML типов, такие как qmlRegisterType() и qmlRegisterSingletonType().

Если qmlName, uri и versionMajor соответствуют зарегистрированному типу, но указанная в versionMinor версия менее актуальна, то возвращается id типа с наиболее близкой мажорной версией.

Возвращает -1, если соответствующий тип не был найден или один из параметров некорректен.

Эта функция была добавлена в Qt 5.12.

См. также QML_ELEMENT, QML_NAMED_ELEMENT, QML_SINGLETON, qmlRegisterType() и qmlRegisterSingletonType().

class Slider : public QObject
{
    Q_OBJECT
    QML_ELEMENT
    ...
}

CONFIG += qmltypes
QML_IMPORT_NAME = com.mycompany.qmlcomponents
QML_IMPORT_MAJOR_VERSION = 1

import com.mycompany.qmlcomponents 1.0

Slider {
    // ...
}

struct FooInterface
{
    QML_INTERFACE
public:
    virtual ~FooInterface();
    virtual void doSomething() = 0;
};

Q_DECLARE_INTERFACE(FooInterface, "org.foo.FooInterface")

class SqlEventDatabase : public QObject
{
    Q_OBJECT
    QML_NAMED_ELEMENT(EventDatabase)

    // ...
};

#ifdef NO_GAMES_ALLOWED
struct MinehuntGame
{
    Q_GADGET
    QML_NAMED_ELEMENT(Game)
    QML_UNAVAILABLE
    QML_UNCREATABLE("Get back to work, slacker!");
};
#else
class MinehuntGame : public QObject
{
    Q_OBJECT
    QML_NAMED_ELEMENT(Game)
    // ...
};
#endif

fun.qml: Get back to work, slacker!
   Game {
   ^