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

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