En esta página

QProperty Class

template <typename T> class QProperty

La clase QProperty es una clase de plantilla que permite el enlace automático de propiedades. Más información...

Encabezado: #include <QProperty>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Desde: Qt 6.0
Heredado de: QPropertyData

Comparaciones de QProperty

CategoríaTipos comparables
igualdadQProperty
igualdadT.

Funciones públicas

QProperty()
QProperty(Functor &&f)
QProperty(T &&initialValue)
QProperty(const QPropertyBinding<T> &binding)
QProperty(const T &initialValue)
~QProperty()
(since 6.2) QPropertyNotifier addNotifier(Functor f)
QPropertyBinding<T> binding() const
QPropertyChangeHandler<Functor> onValueChanged(Functor f)
QPropertyBinding<T> setBinding(const QPropertyBinding<T> &newBinding)
(since 6.0) QPropertyBinding<T> setBinding(Functor f)
bool setBinding(const QUntypedPropertyBinding &newBinding)
void setValue(QProperty<T>::parameter_type newValue)
void setValue(QProperty<T>::rvalue_ref newValue)
(since 6.0) QPropertyChangeHandler<Functor> subscribe(Functor f)
QPropertyBinding<T> takeBinding()
QProperty<T>::parameter_type value() const
QProperty<T> &operator=(QProperty<T>::parameter_type newValue)
QProperty<T> &operator=(QProperty<T>::rvalue_ref newValue)
(since 6.2) void beginPropertyUpdateGroup()
(since 6.2) void endPropertyUpdateGroup()

Descripción detallada

QProperty es una clase de plantilla en la que el parámetro de plantilla T especifica el tipo del valor de la propiedad.

QProperty<T> es una de las clases que implementan las propiedades enlazables de Qt. Se trata de un contenedor que alberga una instancia de T. Se le puede asignar un valor y se puede leer mediante la función value() o el operador de conversión de T. También puedes vincular la propiedad a una expresión que calcule el valor de forma dinámica, la expresión de enlace. Se representa como una lambda de C++ y puede utilizarse para expresar relaciones entre diferentes propiedades de tu aplicación.

Nota: En QML, es importante exponer ` QProperty ` en ` Q_PROPERTY ` con la palabra clave `BINDABLE`. De este modo, el motor de QML la utiliza como interfaz vinculable para configurar el enlace de la propiedad. A su vez, el enlace puede interactuar con C++ a través de la API habitual: QProperty<T>::onValueChanged, QProperty::takeBinding y QBindable::hasBinding. Si la propiedad es BINDABLE, el motor utilizará el seguimiento de cambios inherente al sistema de propiedades de C++ para recibir notificaciones sobre los cambios, y no dependerá de la emisión de señales.

Documentación de las funciones miembro

[default] QProperty::QProperty()

Crea una propiedad con una instancia de T generada por defecto.

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

Crea una propiedad vinculada a la expresión de enlace proporcionada f. El valor de la propiedad se establece en el resultado de evaluar el nuevo enlace. Cada vez que cambie una dependencia del enlace, este se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

[explicit implicit] QProperty::QProperty(T &&initialValue)

Move: crea una propiedad con el valor proporcionado initialValue.

[explicit] QProperty::QProperty(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 de la nueva vinculación. Cada vez que cambie una dependencia de la vinculación, esta se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

[explicit implicit] QProperty::QProperty(const T &initialValue)

Crea una propiedad con el valor proporcionado en « initialValue ».

[default] QProperty::~QProperty()

Destruye la propiedad.

[since 6.2] template <typename Functor> QPropertyNotifier QProperty::addNotifier(Functor f)

Suscribe el functor indicado f como una función de llamada que se ejecuta 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 std::function o incluso una estructura personalizada con un operador de llamada.

El objeto de controlador de cambios de propiedad devuelto realiza un seguimiento de la suscripción. Cuando sale del ámbito, se da de baja la función de llamada.

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

Esta función se introdujo en Qt 6.2.

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

QPropertyBinding<T> QProperty::binding() const

Devuelve la expresión de enlace asociada a esta propiedad. Si no existe dicha asociación, se devolverá un objeto QPropertyBinding<T> creado de forma predeterminada.

Véase también setBinding().

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

Registra el functor dado f como una llamada de retorno que se activará cada vez que cambie el valor de la propiedad. Ante cada cambio de valor, el controlador se activa de forma inmediata o se aplaza, 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 std::function o incluso una estructura personalizada con un operador de llamada.

El objeto de controlador de cambios de propiedad devuelto realiza un seguimiento del registro. Cuando sale del ámbito, se da de baja la llamada de retorno.

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

Asocia el valor de esta propiedad a la expresión « newBinding » proporcionada y devuelve el enlace asociado anteriormente. El valor de la propiedad se establece en el resultado de evaluar el nuevo enlace. Cada vez que cambie una dependencia del enlace, este se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

Véase también binding().

[since 6.0] template <typename Functor> QPropertyBinding<T> QProperty::setBinding(Functor f)

Asocia el valor de esta propiedad al functor proporcionado f y devuelve el enlace asociado anteriormente. El valor de la propiedad se establece en el resultado de evaluar el nuevo enlace. Cada vez que cambie una dependencia del enlace, este se volverá a evaluar y el valor de la propiedad se actualizará en consecuencia.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

Véase también «Formulación deun enlace de propiedad».

bool QProperty::setBinding(const QUntypedPropertyBinding &newBinding)

Asocia el valor de esta propiedad a la expresión « newBinding » proporcionada. El valor de la propiedad se establece en el resultado de evaluar el nuevo enlace. Cada vez que cambie una dependencia del enlace, este 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 tipo que devuelve la función de enlace; en caso contrario, devuelve «false».

Esta es una función sobrecargada.

void QProperty::setValue(QProperty<T>::parameter_type newValue)

void QProperty::setValue(QProperty<T>::rvalue_ref newValue)

Asigna el valor « newValue » a esta propiedad y elimina el enlace asociado a la misma, si lo hay.

[since 6.0] template <typename Functor> QPropertyChangeHandler<Functor> QProperty::subscribe(Functor f)

Suscribe el functor dado f como una llamada de retorno que se ejecuta inmediatamente y cada vez que el valor de la propiedad cambie en el futuro. Ante cada cambio de valor, el controlador se ejecuta de forma inmediata o se aplaza, dependiendo del contexto.

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

El objeto de controlador de cambios de propiedad devuelto realiza un seguimiento de la suscripción. Cuando sale del ámbito, se da de baja la llamada de retorno.

Esta función se introdujo en Qt 6.0.

QPropertyBinding<T> QProperty::takeBinding()

Desvincula la expresión de enlace de esta propiedad y la devuelve. Tras llamar a esta función, el valor de la propiedad solo cambiará si se le asigna un nuevo valor o cuando se establezca un nuevo enlace.

QProperty<T>::parameter_type QProperty::value() const

Devuelve el valor de la propiedad. Es posible que, antes de devolver el valor, se evalúe una expresión de enlace vinculada a esta propiedad.

Véase también setValue().

QProperty<T> &QProperty::operator=(QProperty<T>::parameter_type newValue)

QProperty<T> &QProperty::operator=(QProperty<T>::rvalue_ref newValue)

Asigna ` newValue ` a esta propiedad y devuelve una referencia a este ` QProperty`.

Elementos no miembros relacionados

[since 6.2] void beginPropertyUpdateGroup()

Marca el inicio de un grupo de actualización de propiedades. Dentro de este grupo, al modificar una propiedad no se actualizan inmediatamente las propiedades dependientes ni se activan notificaciones de cambio. Estas se aplazan hasta que el grupo finalice mediante una llamada a ` endPropertyUpdateGroup`.

Los grupos pueden anidarse. En ese caso, el aplazamiento solo finaliza una vez que se ha cerrado el grupo más externo.

Nota: Las notificacionesde cambio solo se envían una vez que todos los valores de las propiedades afectadas por el grupo se hayan actualizado a sus nuevos valores. Esto permite restablecer una invariante de clase si es necesario actualizar varias propiedades, evitando así que cualquier observador externo detecte un estado incoherente.

Esta función se introdujo en Qt 6.2.

Véase también Qt::endPropertyUpdateGroup y QScopedPropertyUpdateGroup.

[since 6.2] void endPropertyUpdateGroup()

Finaliza un grupo de actualización de propiedades. Si se ha finalizado el grupo más externo, en ese momento se producen las evaluaciones de enlace diferidas y las notificaciones.

Advertencia: Llamar a `endPropertyUpdateGroup` sin haber llamado previamente a ` beginPropertyUpdateGroup ` da lugar a un comportamiento indefinido.

Esta función se introdujo en Qt 6.2.

Véanse también « Qt::beginPropertyUpdateGroup » y « QScopedPropertyUpdateGroup ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.