En esta página

QQmlParserStatus Class

La clase `QQmlParserStatus` proporciona información actualizada sobre el estado del analizador de QML. Más información...

Encabezado: #include <QQmlParserStatus>
CMake: find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake: QT += qml
Heredado por:

QQuickItem

Funciones públicas

virtual void classBegin() = 0
virtual void componentComplete() = 0

Descripción detallada

QQmlParserStatus proporciona un mecanismo para que las clases instanciadas por un « QQmlEngine » reciban notificaciones en momentos clave de su creación.

Esta clase se utiliza a menudo con fines de optimización, ya que permite aplazar una operación costosa hasta que se hayan establecido todas las propiedades de un objeto. Por ejemplo, el elemento ` Text ` de QML utiliza el estado del analizador para aplazar el diseño del texto hasta que se hayan establecido todas sus propiedades (no queremos realizar el diseño cuando se asigna ` text `, volver a diseñarlo cuando se asigna ` font `, volver a diseñarlo de nuevo cuando se asigna ` width `, y así sucesivamente).

Ten en cuenta que los métodos de `QQmlParserStatus` solo se invocan cuando una clase es instanciada por un ` QQmlEngine`. Si creas la misma clase directamente desde C++, estos métodos no se invocarán automáticamente. Para evitar este problema, se recomienda empezar a aplazar las operaciones desde ` classBegin ` en lugar de desde la creación inicial de la clase. Esto seguirá evitando múltiples reevaluaciones durante la asignación inicial de enlaces en QML, pero no aplazará las operaciones invocadas desde C++.

Para utilizar QQmlParserStatus, debe heredar tanto de una clase derivada de QObject como de QQmlParserStatus, y utilizar la macro Q_INTERFACES().

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

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

Documentación de las funciones miembro

[pure virtual] void QQmlParserStatus::classBegin()

Se invoca tras la creación de la clase, pero antes de que se haya establecido ninguna propiedad.

[pure virtual] void QQmlParserStatus::componentComplete()

Se invoca una vez que el componente raíz que ha provocado esta instanciación ha finalizado su construcción. En este momento, ya se han asignado a la clase todos los valores estáticos y los valores de enlace.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.