QQuickAttachedPropertyPropagator Class

详细说明

在 QML 中，可以将属性与信号处理程序附加到对象上。关于如何公开自定义的 C++ 附加类型，请参阅“提供附加属性”部分以获取更多详细信息。

QQuickAttachedPropertyPropagator 提供了一组 API，用于将附加属性从父对象传播到其子对象，这与font 和palette 的传播机制类似。它支持通过items 、popups 和windows 进行传播。

如果属性传播并不重要，请考虑改用C++或QML单例，因为它更适合该用例，且效率更高——仅需一个QObject 。

要实现自定义附加属性：

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. 实现一个静态的 `qmlAttachedProperties ` 函数，并使用 `QML_ELEMENT ` 和 `QML_ATTACHED` 将其类型声明为 QML 附加类型，具体请参阅《提供附加属性》中的详细说明：

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

完整的实现请参见《Qt Quick Controls - 附加样式属性示例》。