QObjectBindableProperty Class

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

class Foo : public QObject
{
    Q_OBJECT
    Q_PROPERTY(int myVal READ myVal WRITE setMyVal BINDABLE bindableMyVal)
public:
    int myVal() { return myValMember.value(); }
    void setMyVal(int newvalue) { myValMember = newvalue; }
    QBindable<int> bindableMyVal() { return &myValMember; }
signals:
    void myValChanged();

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

int main()
{
    bool debugout(true); // enable debug log
    Foo myfoo;
    QProperty<int> prop(42);
    QObject::connect(&myfoo, &Foo::myValChanged, [&]() {
        if (debugout)
            qDebug() << myfoo.myVal();
    });
    myfoo.bindableMyVal().setBinding([&]() { return prop.value(); }); // prints "42"

    prop = 5; // prints "5"
    debugout = false;
    prop = 6; // prints nothing
    debugout = true;
    prop = 7; // prints "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(MyClass, CustomType xProp, CustomType(5, 10),
                                     &MyClass::xChanged)

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

このプロパティにnewValue を割り当て、プロパティの関連するバインディングが存在する場合は、それを削除します。その結果、プロパティの値が変更された場合、owner のコールバック関数を呼び出します。

QObjectBindableProperty::QObjectBindableProperty()

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

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

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

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

Move -指定されたinitialValue でプロパティを構築します。

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

提供されたinitialValue でプロパティを構築する。

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

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

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

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

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

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

[default] QObjectBindableProperty::~QObjectBindableProperty()

プロパティを破棄します。

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

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

コールバックf は、パラメータを持たないプレーンな呼び出し演算子() を持つ型であることが期待されます。つまり、C++のラムダ式やstd::関数、あるいはコール演算子を持つカスタム構造体を指定することができます。

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

返されるオブジェクトはテンプレートではないので、このメソッドは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::関数、あるいはコール演算子を持つカスタム構造体を指定することができます。

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

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 を返します。

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

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

コールバックf は、パラメータを持たないプレーンなコール演算子() を持つ型であることが期待されます。つまり、C++のラムダ式やstd::関数、あるいは呼び出し演算子を持つカスタム構造体を指定することができます。

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

QPropertyBinding<T> QObjectBindableProperty::takeBinding()

このプロパティからバインディング式の関連付けを解除し、それを返します。この関数を呼び出した後、プロパティの値は、新しい値を代入した場合、または新しいバインディングが設定された場合にのみ変更されます。

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

プロパティの値を返します。この関数は、値を返す前に、このプロパティに関連付けられているバインディング式を評価することができます。

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