QQuickAttachedPropertyPropagator Class

詳細説明

QMLでは、オブジェクトにプロパティやシグナルハンドラをアタッチすることができます。アタッチド・プロパティの提供では、独自のC++アタッチド型を公開する方法について詳しく説明しています。

font palette QQuickAttachedPropertyPropagator は、親オブジェクトから子オブジェクトにアタッチドプロパティを伝搬する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. 静的なqmlAttachedProperties 関数を実装し、QML_ELEMENT とQML_ATTACHED を用いて、QMLのアタッチド・プロパティとして宣言する：

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

完全な実装はQt Quick Controls - Attached Style Properties Example にあります。