QQmlParserStatus Class

詳細な説明

QQmlParserStatus は、QQmlEngine によってインスタンス化されたクラスが、その生成の重要な時点で通知を受け取るためのメカニズムを提供します。

このクラスは最適化のためによく使われます。なぜなら、オブジェクトにすべてのプロパティが設定された後まで、高価な操作を延期することができるからです。例えば、QMLのText 要素は、すべてのプロパティが設定されるまでテキストのレイアウトを延期するためにパーサーステータスを使用します（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 = nullptr);
    // ...
    void classBegin() override;
    void componentComplete() override;
};