Класс QQmlParserStatus

Класс QQmlParserStatus предоставляет обновления о состоянии парсера QML. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Подробное описание

QQmlParserStatus предоставляет механизм для классов, созданных с помощью QQmlEngine, чтобы получать уведомления в ключевые моменты их создания.

Этот класс часто используется для оптимизации, так как позволяет отложить дорогостоящую операцию до тех пор, пока все свойства не будут установлены для объекта. Например, элемент Text QML использует статус парсера для отсрочки вычисления разметки текста до тех пор, пока все его свойства не будут установлены (мы не хотим выполнять разметку при назначении text, а затем переразмечать при назначении font, и снова переразмечать при назначении width, и так далее).

Обратите внимание, что методы QQmlParserStatus вызываются только при создании класса с помощью QQmlEngine. Если вы создаете тот же класс напрямую из C++, эти методы не будут вызываться автоматически. Чтобы избежать этой проблемы, рекомендуется начать откладывать операции с classBegin, а не с первоначального создания вашего класса. Это по-прежнему предотвратит многократное переоценивание во время первоначального присвоения связей в QML, но не отложит операции, вызываемые из C++.

Чтобы использовать QQmlParserStatus, необходимо унаследовать как класс, производный от QObject, так и QQmlParserStatus, и использовать макрос Q_INTERFACES().

class MyObject : public QObject, public QQmlParserStatus
{
    Q_OBJECT
    Q_INTERFACES(QQmlParserStatus)

public:
    MyObject(QObject *parent = 0);
    // ...
    void classBegin();
    void componentComplete();
};

Документация по членам-функциям

[pure virtual] void QQmlParserStatus::classBegin()

Вызывается после создания класса, но до установки каких-либо свойств.

[pure virtual] void QQmlParserStatus::componentComplete()

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