QQuickAttachedPropertyPropagator Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen QQuickAttachedPropertyPropagator mit dem angegebenen parent.

Die parent wird verwendet, um die attached parent dieses Objekts zu finden.

Abgeleitete Klassen sollten initialize() in ihrem Konstruktor aufrufen.

[virtual noexcept] QQuickAttachedPropertyPropagator::~QQuickAttachedPropertyPropagator()

Zerstört die QQuickAttachedPropertyPropagator.

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

Diese Funktion gibt die angehängten Kinder dieses angehängten Objekts zurück.

Die angehängten Kinder werden bei der Weitergabe von Eigenschaftswerten verwendet:

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

Diese Funktion gibt das angehängte Elternteil dieses angehängten Objekts zurück.

Das angehängte übergeordnete Objekt wird bei der Vererbung von Eigenschaftswerten verwendet:

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)

Diese Funktion wird immer dann aufgerufen, wenn das angehängte Elternteil dieser QQuickAttachedPropertyPropagator von oldParent zu newParent wechselt.

Unterklassen sollten diese Funktion reimplementieren, um angehängte Eigenschaften von newParent zu erben.

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()

Findet und setzt das angehängte übergeordnete Objekt für dieses angehängte Objekt und tut dann dasselbe für seine Kinder. Diese Funktion muss bei der Erstellung des angehängten Objekts aufgerufen werden, damit die Weitergabe funktioniert.

Es kann sinnvoll sein, vor dem Aufruf dieser Funktion die globalen Werte/Standardwerte zu lesen. Beispielsweise prüft der Imagine-Stil vor dem Aufruf von initialize() ein statisches "globalsInitialized"-Flag, um festzustellen, ob er Standardwerte aus QSettings lesen soll. Die Werte aus dieser Datei bilden die Grundlage für alle angehängten Eigenschaftswerte, die nicht explizit festgelegt wurden.

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();
}