QUntypedBindable Class

QUntypedBindable ist eine einheitliche Schnittstelle über bindbare Eigenschaften wie QProperty\<T\> und QObjectBindableProperty eines beliebigen Typs T. Mehr...

Kopfzeile: #include <QUntypedBindable>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Seit: Qt 6.0
Vererbt von:

QBindable

Öffentliche Funktionen

QUntypedBindable()
QUntypedBindable(Property *property)
QPropertyNotifier addNotifier(Functor f)
QUntypedPropertyBinding binding() const
bool hasBinding() const
(since 6.1) bool isReadOnly() const
bool isValid() const
QUntypedPropertyBinding makeBinding(const QPropertyBindingSourceLocation &location = QT_PROPERTY_DEFAULT_BINDING_LOCATION) const
(since 6.2) QMetaType metaType() const
QPropertyChangeHandler<Functor> onValueChanged(Functor f) const
bool setBinding(const QUntypedPropertyBinding &binding)
QPropertyChangeHandler<Functor> subscribe(Functor f) const
(since 6.1) QUntypedPropertyBinding takeBinding()

Detaillierte Beschreibung

QUntypedBindable ist eine vollständig typisierte generische Schnittstelle, um bindbare Eigenschaften zu umhüllen. Sie können sie verwenden, um mit Eigenschaften zu interagieren, ohne ihren Typ zu kennen oder sich darum zu kümmern, welche Art von bindbarer Eigenschaft sie sind (z.B. QProperty oder QObjectBindableProperty). Für die meisten Anwendungsfälle sollte die Verwendung von QBindable<T> (die generisch über die Eigenschaftsimplementierung ist, aber einen festen Typ hat) bevorzugt werden.

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] QUntypedBindable::QUntypedBindable()

Default-konstruiert ein QUntypedBindable. Es befindet sich in einem ungültigen Zustand.

Siehe auch isValid().

template <typename Property> QUntypedBindable::QUntypedBindable(Property *property)

Konstruiert ein QUntypedBindable aus der Eigenschaft property. Wenn Property const ist, ist das QUntypedBindable nur lesbar. Wenn property null ist, ist das QUntypedBindable ungültig.

Siehe auch isValid() und isReadOnly().

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

Installiert f als Change-Handler. Immer wenn sich die zugrunde liegende Eigenschaft ändert, wird f aufgerufen, solange die zurückgegebene QPropertyNotifier und die Eigenschaft erhalten bleiben.

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().

QUntypedPropertyBinding QUntypedBindable::binding() const

Gibt die Bindung der zugrundeliegenden Eigenschaft zurück, wenn es eine gibt, oder andernfalls eine standardmäßig konstruierte QUntypedPropertyBinding.

Siehe auch setBinding() und hasBinding().

bool QUntypedBindable::hasBinding() const

Gibt true zurück, wenn die zugrunde liegende Eigenschaft eine Bindung hat.

[since 6.1] bool QUntypedBindable::isReadOnly() const

Gibt true zurück, wenn die QUntypedBindable schreibgeschützt ist.

Diese Funktion wurde in Qt 6.1 eingeführt.

bool QUntypedBindable::isValid() const

Gibt true zurück, wenn die QUntypedBindable gültig ist. Methoden, die auf einer ungültigen QUntypedBindable aufgerufen werden, haben im Allgemeinen keine Wirkung, sofern nicht anders angegeben.

QUntypedPropertyBinding QUntypedBindable::makeBinding(const QPropertyBindingSourceLocation &location = QT_PROPERTY_DEFAULT_BINDING_LOCATION) const

Erstellt eine Bindung, die den Wert der zugrunde liegenden Eigenschaften zurückgibt, unter Verwendung einer angegebenen Quelle location.

[since 6.2] QMetaType QUntypedBindable::metaType() const

Gibt den Metatyp der Eigenschaft zurück, aus der die QUntypedBindable erstellt wurde. Wenn das bindable ungültig ist, wird ein ungültiger Metatyp zurückgegeben.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch isValid().

template <typename Functor> QPropertyChangeHandler<Functor> QUntypedBindable::onValueChanged(Functor f) const

Installiert f als Change-Handler. Immer wenn sich die zugrunde liegende Eigenschaft ändert, wird f aufgerufen, solange die zurückgegebene QPropertyChangeHandler und die Eigenschaft am Leben gehalten werden. Bei jeder Wertänderung wird der Handler entweder sofort oder zeitversetzt aufgerufen, je nach Kontext.

Siehe auch onValueChanged() und subscribe().

bool QUntypedBindable::setBinding(const QUntypedPropertyBinding &binding)

Setzt die Bindung der zugrunde liegenden Eigenschaft auf binding. Dies hat keine Auswirkungen, wenn QUntypedBindable schreibgeschützt oder null ist oder wenn der Typ von binding mit dem Typ der zugrunde liegenden Eigenschaft übereinstimmt.

Gibt true zurück, wenn die Bindung erfolgreich gesetzt wurde.

Siehe auch binding().

template <typename Functor> QPropertyChangeHandler<Functor> QUntypedBindable::subscribe(Functor f) const

Verhält sich wie ein Aufruf von f gefolgt von onValueChanged(f),

Siehe auch onValueChanged().

[since 6.1] QUntypedPropertyBinding QUntypedBindable::takeBinding()

Entfernt die aktuell eingestellte Bindung von der Eigenschaft und gibt sie zurück. Gibt ein standardmäßig konstruiertes QUntypedPropertyBinding zurück, wenn keine Bindung gesetzt ist.

Diese Funktion wurde in Qt 6.1 eingeführt.

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