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

이 첨부된 객체에 대한 첨부된 부모를 찾아 설정한 다음, 그 자식에 대해서도 동일한 작업을 수행합니다. 전파가 작동하려면 첨부된 객체를 생성할 때 이 함수를 호출해야 합니다.

이 함수를 호출하기 전에 전역/기본값을 읽어두면 유용할 수 있습니다. 예를 들어 Imagine 스타일은 initialize() 을 호출하기 전에 정적 "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();
}