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++ lambda 表达式、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++ lambda 表达式、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++ lambda 表达式、std::function，甚至是带有调用运算符的自定义结构体。

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

QPropertyBinding<T> QObjectBindableProperty::takeBinding()

将绑定表达式从该属性中解除绑定，并返回该属性。调用此函数后，该属性的值仅会在为其赋新值或设置新绑定时发生变化。

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

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

另请参阅 setValue()。