Класс 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().

[since 5.9] QQmlInfo qmlDebug(const QObject *object)

Выводит отладочные сообщения, которые включают имя файла и номер строки для указанного QML-объекта.

Когда QML-типы производят сообщения об ошибках, включение имени файла и номера строки QML-файла, на котором был создан конкретный экземпляр, повышает возможность отслеживания.

Для включения имени файла и номера строки должен быть передан объект. Если имя файла и номер строки недоступны для этого экземпляра (либо он не был создан движком QML, либо информация о расположении отключена), используется «неизвестное местоположение». Например,

qmlDebug(object) << "Internal state: 42";

выводит

QML MyCustomType (unknown location): Internal state: 42

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

См. также qmlInfo и qmlWarning.

QQmlEngine *qmlEngine(const QObject *object)

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

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

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

QQmlInfo qmlInfo(const QObject *object)

Выводит информационные сообщения, которые включают имя файла и номер строки для указанного QML-объекта.

Когда QML-типы производят сообщения об ошибках, включение имени файла и номера строки QML-файла, на котором был создан конкретный экземпляр, повышает возможность отслеживания.

Для включения имени файла и номера строки должен быть передан объект. Если имя файла и номер строки недоступны для этого экземпляра (либо он не был создан движком QML, либо информация о расположении отключена), используется «неизвестное местоположение».

Например,

qmlInfo(object) << tr("component property is a write-once property");

выводит

QML MyCustomType (unknown location): component property is a write-once property

Примечание: В версиях до Qt 5.9 qmlInfo сообщал сообщения, используя предупреждение QtMsgType. В Qt 5.9 и выше qmlInfo использует информацию QtMsgType. Для отправки предупреждений используйте qmlWarning.

См. также qmlDebug и qmlWarning.

bool qmlProtectModule(const char *uri, int majVersion)

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

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

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

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

[since 5.14] 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().

[since 5.9] 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);

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

[since 5.14] 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.

[since 5.14] 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. Url должен быть абсолютным URL, т.е. url.isRelative() == false.

Кроме того, файл QML типа должен иметь директиву pragma 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. Это можно сделать, добавив директиву pragma Singleton в импорты файла QML типа. Кроме того, тип должен быть определён в файле 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. Адрес должен быть абсолютным URL-адресом, т.е. 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.

[since 5.8] 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.

[since 5.12] int qmlTypeId(const char *uri, int versionMajor, int versionMinor, const char *qmlName)

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

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

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

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

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

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

[since 5.9] QQmlInfo qmlWarning(const QObject *object)

Выводит предупреждающие сообщения, которые включают номер файла и строки для указанного QML-объекта.

Когда QML-типы генерируют сообщения регистрации, для повышения возможности отслеживания полезно, чтобы они содержали номер файла и строки QML, в которых был создан конкретный экземпляр.

Для включения номера файла и строки необходимо передать объект. Если номер файла и строки недоступны для данного экземпляра (либо он не был создан движком QML, либо информация о расположении отключена), вместо этого будет использоваться «неизвестное расположение».

Например,

qmlInfo(object) << tr("property cannot be set to 0");

выводит

QML MyCustomType (unknown location): property cannot be set to 0

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

См. также qmlDebug и qmlInfo.

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 {
   ^