QProperty Class

Dokumentation der Mitgliedsfunktionen

Weist dieser Eigenschaft newValue zu und entfernt die zugehörige Bindung der Eigenschaft, falls vorhanden.

Weist dieser Eigenschaft newValue zu und gibt einen Verweis auf diese QProperty zurück.

QProperty::QProperty()

Konstruiert eine Eigenschaft mit einer standardmäßig konstruierten Instanz von T.

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

Konstruiert eine Eigenschaft, die an den angegebenen Bindungsausdruck f gebunden ist. Der Wert der Eigenschaft wird auf das Ergebnis der Auswertung der neuen Bindung gesetzt. Sobald sich eine Abhängigkeit der Bindung ändert, wird die Bindung neu ausgewertet und der Wert der Eigenschaft entsprechend aktualisiert.

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

Move-Konstruiert eine Eigenschaft mit der angegebenen initialValue.

[explicit] QProperty::QProperty(const QPropertyBinding<T> &binding)

Konstruiert eine Eigenschaft, die an den angegebenen Ausdruck binding gebunden ist. Der Wert der Eigenschaft wird auf das Ergebnis der Auswertung der neuen Bindung gesetzt. Sobald sich eine Abhängigkeit der Bindung ändert, wird die Bindung neu ausgewertet und der Wert der Eigenschaft entsprechend aktualisiert.

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

Konstruiert eine Eigenschaft mit der angegebenen initialValue.

QProperty::~QProperty()

Zerstört das Eigentum.

template <typename Functor> QPropertyNotifier QProperty::addNotifier(Functor f)

Zeichnet den angegebenen Funktor f als Callback ab, der immer dann aufgerufen wird, wenn sich der Wert der Eigenschaft ändert.

Es wird erwartet, dass der Rückruf f ein Typ ist, der einen einfachen Aufrufoperator () ohne Parameter hat. Dies bedeutet, dass Sie einen C++-Lambda-Ausdruck, eine std::function oder sogar eine benutzerdefinierte Struktur mit einem Aufrufoperator bereitstellen können.

Das zurückgegebene Property Change Handler-Objekt verfolgt das Abonnement. Wenn es den Anwendungsbereich verlässt, wird der Callback abbestellt.

Diese Methode ist in einigen Fällen einfacher zu verwenden als onValueChanged(), da das zurückgegebene Objekt keine Vorlage ist. Es kann daher leichter gespeichert werden, z. B. als Mitglied in einer Klasse.

Siehe auch onValueChanged() und subscribe().

QPropertyBinding<T> QProperty::binding() const

Gibt den Bindungsausdruck zurück, der mit dieser Eigenschaft verknüpft ist. Ein standardmäßig konstruiertes QPropertyBinding<T> wird zurückgegeben, wenn keine solche Verknüpfung existiert.

Siehe auch setBinding().

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

Registriert den angegebenen Funktor f als Callback, der immer dann aufgerufen werden soll, wenn sich der Wert der Eigenschaft ändert. Bei jeder Wertänderung wird der Handler entweder sofort oder zeitversetzt aufgerufen, je nach Kontext.

Es wird erwartet, dass der Rückruf f ein Typ ist, der einen einfachen Aufrufoperator () ohne Parameter hat. Dies bedeutet, dass Sie einen C++-Lambda-Ausdruck, eine std::function oder sogar eine benutzerdefinierte Struktur mit einem Aufrufoperator angeben können.

Das zurückgegebene Property Change Handler-Objekt behält die Registrierung im Auge. Wenn es den Anwendungsbereich verlässt, wird die Registrierung des Rückrufs aufgehoben.

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

Verknüpft den Wert dieser Eigenschaft mit dem angegebenen Ausdruck newBinding und gibt die zuvor verknüpfte Bindung zurück. Der Wert der Eigenschaft wird auf das Ergebnis der Auswertung der neuen Bindung gesetzt. Immer wenn sich eine Abhängigkeit der Bindung ändert, wird die Bindung neu ausgewertet und der Wert der Eigenschaft entsprechend aktualisiert.

Siehe auch binding().

template <typename Functor> QPropertyBinding<T> QProperty::setBinding(Functor f)

Dies ist eine überladene Funktion.

Verknüpft den Wert dieser Eigenschaft mit dem angegebenen Funktor f und gibt die zuvor verknüpfte Bindung zurück. Der Wert der Eigenschaft wird auf das Ergebnis der Auswertung der neuen Bindung gesetzt. Immer wenn sich eine Abhängigkeit der Bindung ändert, wird die Bindung neu ausgewertet und der Wert der Eigenschaft entsprechend aktualisiert.

Siehe auch Formulierung einer Eigenschaft Bindung.

bool QProperty::setBinding(const QUntypedPropertyBinding &newBinding)

Dies ist eine überladene Funktion.

Verknüpft den Wert dieser Eigenschaft mit dem angegebenen newBinding Ausdruck. Der Wert der Eigenschaft wird auf das Ergebnis der Auswertung der neuen Bindung gesetzt. Immer wenn sich eine Abhängigkeit der Bindung ändert, wird die Bindung neu ausgewertet und der Wert der Eigenschaft entsprechend aktualisiert.

Gibt true zurück, wenn der Typ dieser Eigenschaft derselbe ist wie der Typ, den die Bindungsfunktion zurückgibt; andernfalls false.

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

Abonniert den angegebenen Funktor f als Callback, der sofort und immer dann aufgerufen wird, wenn sich der Wert der Eigenschaft in der Zukunft ändert. Bei jeder Wertänderung wird der Handler entweder sofort oder zeitversetzt aufgerufen, je nach Kontext.

Es wird erwartet, dass der Callback f ein Typ ist, der kopiert werden kann und einen einfachen call operator() ohne Parameter hat. Dies bedeutet, dass Sie einen C++-Lambda-Ausdruck, eine std::function oder sogar eine benutzerdefinierte Struktur mit einem Aufrufoperator bereitstellen können.

Das zurückgegebene Property Change Handler-Objekt verfolgt das Abonnement. Wenn es den Anwendungsbereich verlässt, wird der Callback abbestellt.

QPropertyBinding<T> QProperty::takeBinding()

Entkoppelt den Bindungsausdruck von dieser Eigenschaft und gibt ihn zurück. Nach dem Aufruf dieser Funktion ändert sich der Wert der Eigenschaft nur, wenn Sie ihr einen neuen Wert zuweisen oder wenn eine neue Bindung festgelegt wird.

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

Gibt den Wert der Eigenschaft zurück. Dies kann einen Bindungsausdruck auswerten, der mit dieser Eigenschaft verknüpft ist, bevor der Wert zurückgegeben wird.

Siehe auch setValue().