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 logFoo myfoo;    QProperty<int> prop(42);    QObject::connect(&myfoo, &Foo::myValChanged, [&]() { if (debugout)            qDebug() << myfoo.myVal();
    }); myfoo.bindableMyVal().setBinding([&]() { return prop.value(); }); // imprime "42"prop = 5; // imprime "5"debugout = false; prop = 6; // no imprime nadadebugout = true; prop = 7; // imprime "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)

Documentación de funciones miembro

QObjectBindableProperty::QObjectBindableProperty()

Construye una propiedad con una instancia de T construida por defecto.

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

Crea una propiedad vinculada a la expresión de vinculación proporcionada f. El valor de la propiedad se establece con el resultado de la evaluación de la nueva vinculación. Cada vez que cambie una dependencia de la vinculación, ésta se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

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

Move-Construye una propiedad con la dirección initialValue.

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

Construye una propiedad con la dirección initialValue.

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

Crea una propiedad vinculada a la expresión binding proporcionada. El valor de la propiedad se establece en el resultado de la evaluación del nuevo enlace. Siempre que cambie una dependencia de la vinculación, ésta se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

Cuando cambia el valor de la propiedad, se notifica a owner a través de la función Callback.

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

Crea una propiedad vinculada a la expresión binding proporcionada. El valor de la propiedad se establece en el resultado de la evaluación del nuevo enlace. Siempre que cambie una dependencia de la vinculación, ésta se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

Cuando cambia el valor de la propiedad, se notifica a owner a través de la función Callback.

[default] QObjectBindableProperty::~QObjectBindableProperty()

Destruye la propiedad.

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

Suscribe el functor dado f como una llamada de retorno que se llama cada vez que cambia el valor de la propiedad.

Se espera que la llamada de retorno f sea de un tipo que tenga un operador de llamada simple () sin ningún parámetro. Esto significa que puedes proporcionar una expresión lambda de C++, una función std::function o incluso una estructura personalizada con un operador de llamada.

El objeto manejador de cambio de propiedad devuelto mantiene un seguimiento de la suscripción. Cuando sale del ámbito, se cancela la suscripción a la llamada de retorno.

Este método es en algunos casos más fácil de usar que onValueChanged(), ya que el objeto devuelto no es una plantilla. Por lo tanto, puede almacenarse más fácilmente, por ejemplo, como miembro de una clase.

Véase también onValueChanged() y subscribe().

QPropertyBinding<T> QObjectBindableProperty::binding() const

Devuelve la expresión de vinculación que está asociada a esta propiedad. Se devolverá un QPropertyBinding<T> construido por defecto si no existe tal asociación.

Véase también setBinding().

bool QObjectBindableProperty::hasBinding() const

Devuelve true si la propiedad está asociada a un enlace; false en caso contrario.

void QObjectBindableProperty::notify()

Señala programáticamente un cambio de la propiedad. Cualquier vinculación que dependa de ella será notificada, y si la propiedad tiene una señal, ésta será emitida.

Esto puede ser útil en combinación con setValueBypassingBindings para aplazar la señalización del cambio hasta que se haya restaurado una invariante de la clase.

Véase también Qt::beginPropertyUpdateGroup() y setValueBypassingBindings().

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

Registra el functor dado f como una llamada de retorno que será llamada cada vez que cambie el valor de la propiedad. En cada cambio de valor, el manejador es llamado inmediatamente, o diferido, dependiendo del contexto.

Se espera que la llamada de retorno f sea de un tipo que tenga un operador de llamada simple () sin ningún parámetro. Esto significa que puedes proporcionar una expresión lambda de C++, una función std::function o incluso una estructura personalizada con un operador de llamada.

El objeto manejador de cambio de propiedad devuelto mantiene el registro. Cuando sale del ámbito, la llamada de retorno se desregistra.

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

Asocia el valor de esta propiedad con la expresión newBinding proporcionada y devuelve el enlace asociado previamente. El valor de la propiedad se establece en el resultado de la evaluación del nuevo enlace. Cada vez que cambie una dependencia de la vinculación, ésta se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia. Cuando cambia el valor de la propiedad, se notifica al propietario mediante la función Callback.

Véase también binding().

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

Asocia el valor de esta propiedad con el functor proporcionado f y devuelve la vinculación previamente asociada. El valor de la propiedad se establece con el resultado de evaluar el nuevo enlace invocando al operador de llamada () de f. Cada vez que cambie una dependencia del enlace, éste se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

Cuando cambia el valor de la propiedad, se notifica al propietario a través de la función Callback.

Véase también Formulación de un enlace de propiedad.

bool QObjectBindableProperty::setBinding(const QUntypedPropertyBinding &newBinding)

Asocia el valor de esta propiedad con la expresión newBinding proporcionada. El valor de la propiedad se establece con el resultado de la evaluación del nuevo enlace. Cada vez que cambie una dependencia de la vinculación, ésta se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

Devuelve true si el tipo de esta propiedad es el mismo que el que devuelve la función de vinculación; false en caso contrario.

Asigna newValue a esta propiedad y elimina el enlace asociado a la propiedad, si está presente. Si el valor de la propiedad cambia como resultado, llama a la función Callback en owner.

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

Suscribe el functor dado f como una llamada de retorno que se llama inmediatamente y siempre que el valor de la propiedad cambie en el futuro. En cada cambio de valor, el manejador es llamado inmediatamente, o diferido, dependiendo del contexto.

Se espera que la llamada de retorno f sea de un tipo que tenga un operador de llamada simple () sin ningún parámetro. Esto significa que puedes proporcionar una expresión lambda de C++, una función std::function o incluso una estructura personalizada con un operador de llamada.

El objeto manejador de cambio de propiedad devuelto mantiene un seguimiento de la suscripción. Cuando sale del ámbito, la llamada de retorno se desuscribe.

QPropertyBinding<T> QObjectBindableProperty::takeBinding()

Disocia la expresión de vinculación de esta propiedad y la devuelve. Después de llamar a esta función, el valor de la propiedad sólo cambiará si se le asigna un nuevo valor, o cuando se establezca un nuevo enlace.

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

Devuelve el valor de la propiedad. Puede evaluar una expresión vinculante ligada a esta propiedad antes de devolver el valor.

Véase también setValue().