En esta página

QObjectComputedProperty Class

template <typename Class, typename T, auto Offset, auto Getter> class QObjectComputedProperty

La clase `QObjectComputedProperty` es una clase de plantilla diseñada para facilitar la migración de propiedades antiguas al sistema de propiedades vinculables. Más información...

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

Funciones públicas

Macros

(since 6.0) Q_OBJECT_COMPUTED_PROPERTY(containingClass, type, name, callback)

Descripción detallada

QObjectComputedProperty es una clase de plantilla en la que el parámetro de plantilla Class especifica la clase derivada de QObject que la posee, T especifica el tipo del valor de la propiedad calculada, Offset especifica la ubicación de la propiedad dentro de la clase y Getter especifica la función miembro que calcula el valor de la propiedad.

`QObjectComputedProperty` es una propiedad de solo lectura que se vuelve a calcular en cada lectura. No almacena el valor calculado. Es una de las clases internas de Qt que implementan las propiedades vinculables de Qt. Por lo general, `QObjectComputedProperty` no se utiliza directamente, sino que se crea una instancia de la misma mediante la macro ` Q_OBJECT_COMPUTED_PROPERTY `.

Véase el siguiente ejemplo.

class Client{};

class MyClassPrivate : public QObject
{
public:
    QList<Client> clients;
    bool hasClientsActualCalculation() const { return clients.size() > 0; }
    Q_OBJECT_COMPUTED_PROPERTY(MyClassPrivate, bool, hasClientsData,
                               &MyClassPrivate::hasClientsActualCalculation)
};

class MyClass : public QObject
{
    Q_OBJECT
    Q_PROPERTY(bool hasClients READ hasClients STORED false BINDABLE bindableHasClients)
public:
    QBindable<bool> bindableHasClients()
    {
        return QBindable<bool>(&d_func()->hasClientsData);
    }
    bool hasClients() const
    {
        return d_func()->hasClientsData.value();
    }
    void addClient(const Client &c)
    {
        Q_D(MyClass);
        d->clients.push_back(c);
        // notify that the value could have changed
        d->hasClientsData.notify();
    }
private:
    Q_DECLARE_PRIVATE(MyClass)
};

Las reglas para los getter descritas en «Getters y setters de propiedades vinculables» también se aplican a `QObjectComputedProperty`. En particular, el getter debe ser trivial y devolver únicamente el valor del objeto `QObjectComputedProperty`. La función de devolución de llamada proporcionada a QObjectComputedProperty suele ser un método privado que solo es invocado por QObjectComputedProperty.

No se requiere ni se permite ningún setter, ya que QObjectComputedProperty es de solo lectura.

Para participar correctamente en la gestión de dependencias, QObjectComputedProperty debe saber cuándo su valor —el resultado de la función de llamada de retorno que se le ha pasado— podría haber cambiado. Siempre que cambie una propiedad vinculable utilizada en la llamada de retorno, esto ocurre automáticamente. Si el resultado de la llamada de retorno pudiera cambiar debido a un cambio en un valor que no sea una propiedad vinculable, es responsabilidad del desarrollador llamar a ` notify ` en el objeto `QObjectComputedProperty`. Esto informará a las propiedades dependientes sobre el posible cambio.

Ten en cuenta que llamar a ` notify ` puede activar controladores de cambios en las propiedades dependientes, que a su vez podrían utilizar el objeto del que forma parte `QObjectComputedProperty`. Por lo tanto, no se debe llamar a ` notify ` cuando se encuentre en un estado transitorio o no válido.

QObjectComputedProperty no es adecuado para su uso con un cálculo que dependa de cualquier entrada que pueda cambiar sin previo aviso, como el contenido de un archivo.

Véase también Q_OBJECT_COMPUTED_PROPERTY, QProperty, QObjectBindableProperty, el sistema de propiedades de Qt y las propiedades vinculables de Qt.

Documentación de las funciones miembro

[default] QObjectComputedProperty::QObjectComputedProperty()

Crea por defecto una instancia de ` QObjectComputedProperty`.

Documentación de macros

[since 6.0] Q_OBJECT_COMPUTED_PROPERTY(containingClass, type, name, callback)

Declara un « QObjectComputedProperty » dentro de « containingClass » de tipo « type » con el nombre « name ». El argumento « callback » especifica una función GETTER que se llamará cuando se evalúe la propiedad.

Esta macro se introdujo en Qt 6.0.

Véase también QObjectBindableProperty, el sistema de propiedades de Qt y las propiedades vinculables de Qt.

© 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.