QQuickAttachedPropertyPropagator Class

상세 설명

QML에서는 객체에 속성과 신호 핸들러를 연결할 수 있습니다. ‘Attached Properties 제공’ 섹션에서는 사용자 정의 C++ 연결형(attached type)을 노출하는 방법에 대해 더 자세히 설명합니다.

QQuickAttachedPropertyPropagator는 font 및 palette 전파와 유사하게, 부모 객체에서 자식 객체로 부착된 속성을 전파하는 API를 제공합니다. 이 클래스는 items, popups 및 windows 를 통한 전파를 지원합니다.

속성 전파가 중요하지 않다면, 해당 사용 사례에 더 적합하고 QObject 가 하나만 필요하다는 점에서 더 효율적인 C++ 또는 QML 싱글톤을 대신 사용하는 것을 고려해 보십시오.

사용자 정의 부착 속성을 구현하려면:

1. 부착 속성을 노출하는 클래스를 QQuickAttachedPropertyPropagator에서 파생시킵니다.

   예를 들어, MyStyle.theme 속성을 구현하려면 MyStyle 클래스를 다음과 같이 선언합니다:

   class MYSTYLE_EXPORT MyStyle : public QQuickAttachedPropertyPropagator

2. 클래스의 생성자에서 ` initialize()`를 호출합니다:

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

3. 필요에 따라 부착 속성에 대한 set/inherit/propagate/reset 함수를 정의합니다. 예를 들어, theme 부착 속성을 정의하려면:

   MyStyle::Theme MyStyle::theme() const
   {
       return m_theme;
   }
   
   void MyStyle::setTheme(Theme theme)
   {
       // When this function is called, we know that the user has explicitly
       // set a theme on this attached object. We set this to true even if
       // the effective theme didn't change, because it's important that
       // the user's specified value is respected (and not inherited from
       // from the parent).
       m_explicitTheme = true;
       if (m_theme == theme)
           return;
   
       m_theme = theme;
       propagateTheme();
       themeChange();
   
   }
   
   void MyStyle::inheritTheme(Theme theme)
   {
       if (m_explicitTheme || m_theme == theme)
           return;
   
       m_theme = theme;
       propagateTheme();
       themeChange();
   }
   
   void MyStyle::propagateTheme()
   {
       const auto styles = attachedChildren();
       for (QQuickAttachedPropertyPropagator *child : styles) {
           MyStyle *myStyle = qobject_cast<MyStyle *>(child);
           if (myStyle)
               myStyle->inheritTheme(m_theme);
       }
   }
   
   void MyStyle::resetTheme()
   {
       if (!m_explicitTheme)
           return;
   
       m_explicitTheme = false;
       MyStyle *myStyle = qobject_cast<MyStyle *>(attachedParent());
       inheritTheme(myStyle ? myStyle->theme() : globalTheme);
   }

4. 속성 상속을 처리하려면 attachedParentChange()을 재구현하십시오:

   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...
       }
   }

5. '부착 속성 제공(Providing Attached Properties)' 섹션에 자세히 설명된 대로, 정적 qmlAttachedProperties 함수를 구현하고 QML_ELEMENT 및 QML_ATTACHED 를 사용하여 해당 유형을 부착된 QML 유형으로 선언하십시오:

   MyStyle *MyStyle::qmlAttachedProperties(QObject *object)
   {
       return new MyStyle(object);
   }

전체 구현 내용은 ‘Qt Quick Controls - 첨부된 스타일 속성 예제’에서 확인할 수 있습니다.