QQuickAttachedPropertyPropagator Class

詳細な説明

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

QQuickAttachedPropertyPropagatorは、font やpalette の伝播と同様に、親オブジェクトから子オブジェクトへアタッチされたプロパティを伝播するためのAPIを提供します。これは、items 、popups 、およびwindows を通じた伝播をサポートしています。

プロパティの伝播が重要でない場合は、代わりにC++またはQMLのシングルトンを使用することを検討してください。シングルトンはそのユースケースにより適しており、QObject を 1 つだけ必要とするため、より効率的です。

カスタムアタッチドプロパティを実装するには：

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 コントロール - アタッチド・スタイル・プロパティの例」でご覧いただけます。