QQmlParserStatus Class

Description détaillée

QQmlParserStatus fournit un mécanisme permettant aux classes instanciées par QQmlEngine de recevoir des notifications à des moments clés de leur création.

Cette classe est souvent utilisée à des fins d'optimisation, car elle permet de différer une opération coûteuse jusqu'à ce que toutes les propriétés d'un objet aient été définies. Par exemple, l'élément Text de QML utilise le statut de l'analyseur pour différer la mise en page du texte jusqu'à ce que toutes ses propriétés aient été définies (nous ne voulons pas mettre en page lorsque l'élément text est assigné, puis relayer lorsque l'élément font est assigné, et relayer à nouveau lorsque l'élément width est assigné, et ainsi de suite).

Sachez que les méthodes QQmlParserStatus ne sont appelées que lorsqu'une classe est instanciée par un QQmlEngine. Si vous créez la même classe directement à partir de C++, ces méthodes ne seront pas appelées automatiquement. Pour éviter ce problème, il est recommandé de commencer à différer les opérations à partir de classBegin plutôt qu'à partir de la création initiale de votre classe. Cela permettra d'éviter les réévaluations multiples lors de l'affectation initiale de la liaison en QML, mais ne différera pas les opérations invoquées à partir de C++.

Pour utiliser QQmlParserStatus, vous devez hériter à la fois d'une classe dérivée de QObject et de QQmlParserStatus, et utiliser 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;
};