QObjectBindableProperty 类

#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 上调用 Callback 函数。

QObjectBindableProperty::QObjectBindableProperty()

使用 T 的默认构造实例构造属性。

[显式] QObjectBindableProperty::QObjectBindableProperty(const T &initialValue)

使用提供的 initialValue 构造属性。

[显式] QοBJECT可绑定属性::QObjectBindableProperty(T &&initialValue)

构造一个具有给定 initialValue 的属性。

[显式] template <typename Functor> QοBJECT可绑定属性::QObjectBindableProperty(Functor &&f)

构造一个与提供的绑定表达式 f 绑定的属性。属性的值设置为新的绑定计算结果。每次绑定依赖项更改时，都会重新评估绑定，并根据需要相应地更新属性的值。

[默认] QοBJECT可绑定属性::QObjectBindableProperty(Class *owner, const QPropertyBinding<T> &binding)

构造一个与提供的 binding 表达式绑定的属性。属性的值设置为新的绑定计算结果。每次绑定依赖项更改时，都会重新评估绑定，并根据需要相应地更新属性的值。

当属性值更改时，通过回调函数通知 owner。

[默认] QοBJECT可绑定属性::QObjectBindableProperty(Class *owner, QPropertyBinding<T> &&binding)

构造一个与提供的 binding 表达式绑定的属性。属性的值设置为新的绑定计算结果。每次绑定依赖项更改时，都会重新评估绑定，并根据需要相应地更新属性的值。

当属性值更改时，通过回调函数通知 owner。

[默认] QοBJECT可绑定属性::~QObjectBindableProperty()

销毁属性。

template <typename Functor> QPropertyNotifier QοBJECT可绑定属性::addNotifier(Functor f)

将给定的函数对象 f 作为回调订阅，在属性值更改时调用。

回调 f 应该是一种类型，它有一个不带任何参数的plain call运算符 ()。这意味着您可以提供一个C++ lambda表达式、std::function或者甚至一个具有调用运算符的自定义结构。

返回的属性更改处理对象会跟踪订阅。当它超出作用域时，回调将被取消订阅。

在某些情况下，此方法比onValueChanged()() 更容易使用，因为返回的对象不是模板。因此，它更容易被存储，例如作为类的成员。

另请参阅onValueChanged() 和 subscribe()。

QPropertyBinding<T> QοBJECT可绑定属性::binding() const

返回与该属性关联的绑定表达式。如果没有此类关联，将返回默认构造的 QPropertyBinding<T>。

另请参阅setBinding()。

bool QοBJECT可绑定属性::hasBinding() const

如果属性与绑定相关联，则返回 true；否则返回 false。

void QοBJECT可绑定属性::notify()

通过编程方式触发属性变化信号。任何依赖于它的绑定都将被通知，如果该属性有一个信号，则将发出该信号。

这可以与setValueBypassingBindings结合使用，以延迟信号变化，直到类的不变式得以恢复。

另请参阅：Qt::beginPropertyUpdateGroup() 和 setValueBypassingBindings。

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

将给定的函数[i]注册为回调，在属性值变化时调用该回调。每次值变化时，处理程序将根据上下文立即调用或延迟调用。

回调 f 应该是一种类型，它有一个不带任何参数的plain call运算符 ()。这意味着您可以提供一个C++ lambda表达式、std::function或者甚至一个具有调用运算符的自定义结构。

返回的属性变化处理程序对象跟踪注册。当它超出范围时，回调将被注销。

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

将此属性的值与提供的[i]新绑定表达式关联，并返回先前关联的绑定。将属性值设置为评估新绑定的结果。每当绑定的依赖项发生变化时，将重新评估该绑定，并相应地更新属性值。当属性值变化时，将通过回调函数通知所有者。

另请参阅：binding。

bool QObjectBindableProperty::setBinding(const QUntypedPropertyBinding &newBinding)

这是重载函数。

将此属性的值与提供的[i]新绑定表达式关联。将属性值设置为评估新绑定的结果。每当绑定的依赖项发生变化时，将重新评估该绑定，并相应地更新属性值。

如果此属性的类型与绑定函数返回的类型相同，则返回true；否则返回false。

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

这是重载函数。

将此属性的值与提供的函数[i]关联，并返回先前关联的绑定。将属性值设置为通过调用[i]的调用操作符()评估新绑定的结果。每当绑定的依赖项发生变化时，将重新评估该绑定，并相应地更新属性值。

当属性值变化时，将通知所有者。

另请参阅：定义属性绑定。

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

将给定的泛型函数f作为回调立即调用，并在将来该属性的值发生变化时调用。每当属性值发生变化时，处理程序要么立即调用，要么根据上下文延迟调用。

回调 f 应该是一种类型，它有一个不带任何参数的plain call运算符 ()。这意味着您可以提供一个C++ lambda表达式、std::function或者甚至一个具有调用运算符的自定义结构。

返回的属性更改处理对象会跟踪订阅。当它超出作用域时，回调将被取消订阅。

QPropertyBinding<T> QObjectBindableProperty::takeBinding()

断开绑定表达式与该属性的关联，并返回它。调用此函数后，只有当你为其赋新值或设置新绑定时，属性的值才会更改。

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

返回属性的值。在返回值之前，这可能会评估与该属性绑定的绑定表达式。

另请参阅 setValue。