QObjectComputedProperty Class

Description détaillée

QObjectComputedProperty est une classe de modèle où le paramètre de modèle Class spécifie la classe dérivée d'QObject, T spécifie le type de la valeur de la propriété calculée, Offset spécifie l'emplacement de la propriété au sein de la classe, et Getter spécifie la fonction membre qui calcule la valeur de la propriété.

QObjectComputedProperty est une propriété en lecture seule qui est recalculée à chaque lecture. Elle ne stocke pas la valeur calculée. Il s’agit de l’une des classes internes de Qt implémentant les propriétés liables (Bindable Properties) de Qt. QObjectComputedProperty n’est généralement pas utilisée directement ; à la place, une instance de cette classe 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 relatives aux accesseurs décrites dans la section « Accesseurs et mutateurs des propriétés liables » s’appliquent également à QObjectComputedProperty. En particulier, l’accesseur doit être trivial et se contenter de renvoyer la valeur de l’objet QObjectComputedProperty. La fonction de rappel fournie à `QObjectComputedProperty` doit généralement être une méthode privée qui n’est appelée que par `QObjectComputedProperty`.

Aucun setter n’est requis ni autorisé, car QObjectComputedProperty est en lecture seule.

Pour participer correctement à la gestion des dépendances, QObjectComputedProperty doit savoir quand sa valeur, c’est-à-dire le résultat de la fonction de rappel qui lui est fournie, a pu changer. Chaque fois qu’une propriété liable utilisée dans la fonction de rappel change, cela se produit automatiquement. Si le résultat de la fonction de rappel est susceptible de changer en raison d’une modification d’une valeur qui n’est pas une propriété liable, il incombe au développeur d’appeler la méthode ` notify ` sur l’objet `QObjectComputedProperty`. Cela informera les propriétés dépendantes de ce changement potentiel.

Notez que l’appel de ` notify ` peut déclencher des gestionnaires de changement dans les propriétés dépendantes, qui peuvent à leur tour utiliser l’objet dont `QObjectComputedProperty` est un membre. Par conséquent, ` notify ` ne doit pas être appelé lorsque l’objet se trouve dans un état transitoire ou invalide.

QObjectComputedProperty n’est pas adapté à une utilisation avec un calcul dépendant d’une entrée susceptible de changer sans préavis, comme le contenu d’un fichier.