QObjectComputedProperty Class

Detaillierte Beschreibung

QObjectComputedProperty ist eine schreibgeschützte Eigenschaft, die bei jedem Lesen neu berechnet wird. Sie speichert den berechneten Wert nicht. Sie ist eine der Qt-internen Klassen, die Qt Bindable Properties implementieren. QObjectComputedProperty wird normalerweise nicht direkt verwendet, stattdessen wird eine Instanz davon mit Hilfe des Q_OBJECT_COMPUTED_PROPERTY Makros erstellt.

Siehe das folgende Beispiel.

class Client{};

class MyClassPrivate : public QObjectPrivate
{
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)
};

Die Regeln für Getter in Bindable Property Getters und Setters gelten auch für QObjectComputedProperty. Insbesondere sollte der Getter trivial sein und nur den Wert des QObjectComputedProperty-Objekts zurückgeben. Der Callback, der dem QObjectComputedProperty übergeben wird, sollte normalerweise eine private Methode sein, die nur vom QObjectComputedProperty aufgerufen wird.

Es ist kein Setter erforderlich oder erlaubt, da QObjectComputedProperty schreibgeschützt ist.

Um korrekt an der Behandlung von Abhängigkeiten teilzunehmen, muss QObjectComputedProperty wissen, wann sich sein Wert, das Ergebnis des ihm gegebenen Callbacks, geändert haben könnte. Wann immer sich eine bindbare Eigenschaft, die im Callback verwendet wird, ändert, geschieht dies automatisch. Wenn sich das Ergebnis des Callbacks aufgrund einer Änderung eines Wertes ändern könnte, der keine bindbare Eigenschaft ist, liegt es in der Verantwortung des Entwicklers, notify für das QObjectComputedProperty-Objekt aufzurufen. Dadurch werden abhängige Eigenschaften über die mögliche Änderung informiert.

Beachten Sie, dass der Aufruf von notify Änderungshandler in abhängigen Eigenschaften auslösen könnte, die wiederum das Objekt verwenden könnten, von dem QObjectComputedProperty ein Mitglied ist. Daher darf notify nicht aufgerufen werden, wenn es sich in einem Übergangs- oder ungültigen Zustand befindet.

QObjectComputedProperty eignet sich nicht für die Verwendung mit einer Berechnung, die von einer Eingabe abhängt, die sich unbemerkt ändern kann, wie z.B. der Inhalt einer Datei.