QObjectBindableProperty Class

#include <QObject>
#include <QProperty>
#include <QDebug>

classFoo :publicQObject
{
    Q_OBJECT
    Q_PROPERTY(intmyVal READ myVal WRITE setMyVal BINDABLE bindableMyVal)
public:
    intmyVal() {returnmyValMember.value(); }
   voidsetMyVal(intnewvalue) { myValMember=newvalue; }
    QBindable<int>bindableMyVal() {return &myValMember; }
signals:
    voidmyValChanged();

private:
    Q_OBJECT_BINDABLE_PROPERTY(Foo, int,myValMember, &Foo::myValChanged);
};

intmain()
{
    booldebugout(true);// デバッグログを有効化
    Foo myfoo;
    QProperty<int>prop(42);
    QObject::connect(&myfoo, &Foo::myValChanged, [&]() {
        if(debugout)
            qDebug() << myfoo.myVal();
    });
    myfoo.bindableMyVal().setBinding([&]() {returnprop.value(); });// 「42」と出力される

    prop= 5;// 「5」と出力される
    debugout= false;
    prop= 6;// 何も出力されない
    debugout= true;
    prop= 7;// "7" が出力される
}

#include "main.moc"

class MyClass : public QObject
{
    Q_OBJECT
    Q_PROPERTY(int x READ x WRITE setX NOTIFY xChanged BINDABLE bindableX)
public:
    int x() const { return xProp; }
    void setX(int x) { xProp = x; }
    QBindable<int> bindableX() { return QBindable<int>(&xProp); }

signals:
    void xChanged();

private:
    // Declare the instance of the bindable property data.
    Q_OBJECT_BINDABLE_PROPERTY(MyClass, int, xProp, &MyClass::xChanged)
};

class MyClass : public QObject
{
    Q_OBJECT
    Q_PROPERTY(int x READ x WRITE setX NOTIFY xChanged BINDABLE bindableX)
public:
    int x() const { return xProp; }
    void setX(int x) { xProp = x; }
    QBindable<int> bindableX() { return QBindable<int>(&xProp); }

signals:
    void xChanged();

private:
    // Declare the instance of int bindable property data and
    // initialize it with the value 5.
    // This is similar to declaring
    // int xProp = 5;
    // without using the new QObjectBindableProperty class.
    Q_OBJECT_BINDABLE_PROPERTY_WITH_ARGS(MyClass, int, xProp, 5, &MyClass::xChanged)
};

class CustomType
{
public:
    CustomType(int val, int otherVal) : value(val), anotherValue(otherVal) { }

private:
    int value = 0;
    int anotherValue = 0;
};

// later when using CustomType as a property
Q_OBJECT_BINDABLE_PROPERTY_WITH_ARGS(SomeClass, CustomType, xProp, CustomType(5, 10),
                                    &MyClass::xChanged)

メンバ関数のドキュメント

[default] QObjectBindableProperty::QObjectBindableProperty()

T のデフォルト構築されたインスタンスを持つプロパティを構築します。

[explicit] template <typename Functor> QObjectBindableProperty::QObjectBindableProperty(Functor &&f)

指定されたバインディング式 `f` に紐づくプロパティを作成します。このプロパティの値は、新しいバインディングを評価した結果に設定されます。バインディングの依存関係が変更されるたびに、バインディングが再評価され、それに応じてプロパティの値が更新されます。

[explicit] QObjectBindableProperty::QObjectBindableProperty(T &&initialValue)

Move-Constructs：指定されたinitialValue を使用してプロパティを構築します。

[explicit] QObjectBindableProperty::QObjectBindableProperty(const T &initialValue)

指定されたinitialValue を使用してプロパティを作成します。

[implicit] QObjectBindableProperty::QObjectBindableProperty(Class *owner, QPropertyBinding<T> &&binding)

指定されたbinding 式に紐づくプロパティを作成します。プロパティの値は、新しいバインディングを評価した結果に設定されます。バインディングの依存関係が変更されるたびに、バインディングが再評価され、プロパティの値もそれに応じて更新されます。

プロパティの値が変更されると、コールバック関数を通じてowner に通知されます。

[implicit] QObjectBindableProperty::QObjectBindableProperty(Class *owner, const QPropertyBinding<T> &binding)

指定されたbinding 式に紐づくプロパティを作成します。プロパティの値は、新しいバインディングを評価した結果に設定されます。バインディングの依存関係が変更されるたびに、バインディングは再評価され、それに応じてプロパティの値が更新されます。

プロパティの値が変更されると、owner にはコールバック関数を通じて通知されます。

[implicit] QObjectBindableProperty::~QObjectBindableProperty()

その特性を破壊する。

template <typename Functor> QPropertyNotifier QObjectBindableProperty::addNotifier(Functor f)

指定されたファンクタf を、プロパティの値が変更されるたびに呼び出されるコールバックとして登録します。

コールバック `f ` は、引数を持たない単純な呼び出し演算子 `() ` を持つ型であることが求められます。つまり、C++ のラムダ式、`std::function`、あるいは呼び出し演算子を持つカスタム構造体などを指定することができます。

返されるプロパティ変更ハンドラオブジェクトは、サブスクリプションを追跡します。このオブジェクトがスコープ外になると、コールバックのサブスクリプションは解除されます。

このメソッドは、返されるオブジェクトがテンプレートではないため、場合によってはonValueChanged() よりも使いやすくなっています。そのため、例えばクラスのメンバとして、より簡単に格納することができます。

onValueChanged() およびsubscribe()も参照してください 。

QPropertyBinding<T> QObjectBindableProperty::binding() const

このプロパティに関連付けられているバインディング式を返します。そのような関連付けが存在しない場合は、デフォルトで生成された QPropertyBinding<T> が返されます。

setBinding()も参照してください 。

bool QObjectBindableProperty::hasBinding() const

そのプロパティがバインディングに関連付けられている場合は true を返し、そうでない場合は false を返します。

void QObjectBindableProperty::notify()

プロパティの変更をプログラム的に通知します。そのプロパティに依存するすべてのバインディングに通知が行われ、そのプロパティにシグナルが定義されている場合は、そのシグナルが発行されます。

これは、setValueBypassingBindings と組み合わせて使用することで、クラスの不変条件が回復されるまで変更の通知を遅らせるのに役立ちます。

Qt::beginPropertyUpdateGroup() およびsetValueBypassingBindings()も参照してください 。

template <typename Functor> QPropertyChangeHandler<Functor> QObjectBindableProperty::onValueChanged(Functor f)

指定されたファンクターf を、プロパティの値が変更されるたびに呼び出されるコールバックとして登録します。値が変更されるたびに、コンテキストに応じて、ハンドラが即座に呼び出されるか、呼び出しが遅延されます。

コールバック `f ` は、引数を持たない単純な呼び出し演算子 `() ` を持つ型であることが求められます。つまり、C++ のラムダ式、`std::function`、あるいは呼び出し演算子を持つカスタム構造体を指定することができます。

返されるプロパティ変更ハンドラオブジェクトは、登録情報を追跡します。このオブジェクトがスコープ外になると、コールバックの登録は解除されます。

QPropertyBinding<T> QObjectBindableProperty::setBinding(const QPropertyBinding<T> &newBinding)

このプロパティの値を、指定されたnewBinding 式に関連付け、以前に関連付けられていたバインディングを返します。プロパティの値は、新しいバインディングを評価した結果に設定されます。バインディングの依存関係が変更されるたびに、バインディングは再評価され、プロパティの値はそれに応じて更新されます。 プロパティの値が変更されると、コールバック関数を通じて所有者に通知されます。

binding()も参照してください 。

template <typename Functor> QPropertyBinding<T> QObjectBindableProperty::setBinding(Functor f)

このプロパティの値を、指定されたファンクタ `f ` と関連付け、以前に関連付けられていたバインディングを返します。プロパティの値は、f のコール演算子 `() ` を呼び出して新しいバインディングを評価した結果に設定されます。バインディングの依存関係が変更されるたびに、バインディングは再評価され、プロパティの値はそれに応じて更新されます。

プロパティの値が変更されると、コールバック関数を通じて所有者に通知されます。

「プロパティバインディングの構築」も参照してください 。

bool QObjectBindableProperty::setBinding(const QUntypedPropertyBinding &newBinding)

このプロパティの値を、指定されたnewBinding 式に関連付けます。プロパティの値は、新しいバインディングを評価した結果に設定されます。バインディングの依存関係が変更されるたびに、バインディングが再評価され、それに応じてプロパティの値が更新されます。

このプロパティの型が、バインディング関数が返す型と同じ場合は `true ` を返し、それ以外の場合は `false ` を返します。

このプロパティに `newValue ` を割り当て、関連付けられているバインディングがある場合はそれを解除します。その結果としてプロパティの値が変更された場合、owner 上の `Callback` 関数を呼び出します。

template <typename Functor> QPropertyChangeHandler<Functor> QObjectBindableProperty::subscribe(Functor f)

指定されたファンクタf を、即座に呼び出されるコールバックとして登録し、今後プロパティの値が変更されるたびに呼び出されます。値が変更されるたびに、コンテキストに応じて、ハンドラは即座に呼び出されるか、または呼び出しが延期されます。

コールバック `f ` は、引数を持たない単純な呼び出し演算子 `() ` を持つ型であることが求められます。つまり、C++ のラムダ式、`std::function`、あるいは呼び出し演算子を持つカスタム構造体などを指定することができます。

返されるプロパティ変更ハンドラオブジェクトは、サブスクリプションを追跡します。このオブジェクトがスコープ外になると、コールバックのサブスクリプションは解除されます。

QPropertyBinding<T> QObjectBindableProperty::takeBinding()

このプロパティからバインディング式を切り離し、それを返します。この関数を呼び出した後、プロパティの値が変更されるのは、新しい値を代入した場合、または新しいバインディングが設定された場合のみとなります。

QObjectBindableProperty<Class, T, Offset, Signal>::parameter_type QObjectBindableProperty::value() const

プロパティの値を返します。値を返す前に、このプロパティに紐付けられたバインディング式が評価される場合があります。

setValue()も参照してください 。