QQuickAttachedPropertyPropagator Class

メンバ関数 ドキュメント

[explicit] QQuickAttachedPropertyPropagator::QQuickAttachedPropertyPropagator(QObject *parent = nullptr)

与えられたparent で QQuickAttachedPropertyPropagator を構築します。

parent は、このオブジェクトのattached parent を見つけるために使用されます。

派生クラスは、コンストラクタ内でinitialize() を呼び出す必要があります。

[virtual noexcept] QQuickAttachedPropertyPropagator::~QQuickAttachedPropertyPropagator()

QQuickAttachedPropertyPropagator を破棄します。

QList<QQuickAttachedPropertyPropagator *> QQuickAttachedPropertyPropagator::attachedChildren() const

この関数は、このアタッチされたオブジェクトのアタッチされた子を返します。

アタッチされた子オブジェクトは、プロパティ値を伝搬する際に使用されます：

void MyStyle::propagateTheme()
{
    const auto styles = attachedChildren();
    for (QQuickAttachedPropertyPropagator *child : styles) {
        MyStyle *myStyle = qobject_cast<MyStyle *>(child);
        if (myStyle)
            myStyle->inheritTheme(m_theme);
    }
}

QQuickAttachedPropertyPropagator *QQuickAttachedPropertyPropagator::attachedParent() const

この関数は、このアタッチされたオブジェクトのアタッチされた親を返します。

アタッチされた親は、プロパティ値を継承するときに使用されます：

void MyStyle::resetTheme()
{
    if (!m_explicitTheme)
        return;

    m_explicitTheme = false;
    MyStyle *myStyle = qobject_cast<MyStyle *>(attachedParent());
    inheritTheme(myStyle ? myStyle->theme() : globalTheme);
}

[virtual protected] void QQuickAttachedPropertyPropagator::attachedParentChange(QQuickAttachedPropertyPropagator *newParent, QQuickAttachedPropertyPropagator *oldParent)

この関数は、このQQuickAttachedPropertyPropagator のアタッチされた親がoldParent からnewParent に変わるたびに呼び出されます。

サブクラスは、newParent からアタッチド・プロパティを継承するために、この関数を再実装する必要があります。

void MyStyle::attachedParentChange(QQuickAttachedPropertyPropagator *newParent, QQuickAttachedPropertyPropagator *oldParent)
{
    Q_UNUSED(oldParent);
    MyStyle *attachedParentStyle = qobject_cast<MyStyle *>(newParent);
    if (attachedParentStyle) {
        inheritTheme(attachedParentStyle->theme());
        // Do any other inheriting here...
    }
}

[protected] void QQuickAttachedPropertyPropagator::initialize()

このアタッチドオブジェクトのアタッチドペアレントを検索して設定し、その子オブジェクトにも同じことを行います。伝播させるためには、アタッチドオブジェクトの構築時にこの関数を呼び出す必要があります。

この関数を呼び出す前に、グローバル値やデフォルト値を読み込んでおくと便利です。例えば、initialize() を呼び出す前に、Imagineスタイルは静的な「globalsInitialized」フラグをチェックして、QSettings からデフォルト値を読み込む必要があるかどうかを確認します。このファイルの値は、明示的に設定されていないアタッチされたプロパティ値の基礎となります。

MyStyle::MyStyle(QObject *parent)
    : QQuickAttachedPropertyPropagator(parent)
    , m_theme(globalTheme)
{
    // A static function could be called here that reads globalTheme from a
    // settings file once at startup. That value would override the global
    // value. This is similar to what the Imagine and Material styles do, for
    // example.

    initialize();
}