QObjectComputedProperty Class

Description détaillée

QObjectComputedProperty est une propriété en lecture seule qui est recalculée à chaque lecture. Elle ne stocke pas la valeur calculée. C'est l'une des classes internes de Qt qui implémentent les propriétés liées de Qt. QObjectComputedProperty n'est généralement pas utilisée directement, mais une instance est créée à l'aide de la macro Q_OBJECT_COMPUTED_PROPERTY.

Voir l'exemple suivant.

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)
};

Les règles applicables aux getters dans Bindable Property Getters and Setters s'appliquent également à QObjectComputedProperty. En particulier, le getter doit être trivial et ne renvoyer que la valeur de l'objet QObjectComputedProperty. Le rappel donné à QObjectComputedProperty doit généralement être une méthode privée qui n'est appelée que par QObjectComputedProperty.

Aucun setter n'est requis ou autorisé, car QObjectComputedProperty est en lecture seule.

Pour participer correctement à la gestion des dépendances, QObjectComputedProperty doit savoir quand sa valeur, le résultat du rappel qui lui est donné, peut avoir changé. Chaque fois qu'une propriété liante utilisée dans le rappel change, cela se produit automatiquement. Si le résultat du rappel risque de changer en raison d'une modification d'une valeur qui n'est pas une propriété liante, il incombe au développeur d'appeler notify sur l'objet QObjectComputedProperty. Les propriétés dépendantes seront ainsi informées de la modification potentielle.

Notez que l'appel à notify peut déclencher des gestionnaires de changement dans les propriétés dépendantes, qui peuvent à leur tour utiliser l'objet dont la QObjectComputedProperty est membre. C'est pourquoi notify ne doit pas être appelé dans un état transitoire ou invalide.

QObjectComputedProperty ne convient pas à une utilisation avec un calcul qui dépend d'une entrée susceptible de changer sans préavis, comme le contenu d'un fichier.