Auf dieser Seite

QUntypedBindable Class

QUntypedBindable ist eine einheitliche Schnittstelle für bindbare Eigenschaften wie QProperty\<T\> und QObjectBindableProperty beliebiger Typen T. Mehr...

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

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

Ausführliche Beschreibung

QUntypedBindable ist eine vollständig typgelöschte generische Schnittstelle zum Umschließen von bindbaren Eigenschaften. Sie können sie verwenden, um mit Eigenschaften zu interagieren, ohne deren Typ zu kennen oder sich darum zu kümmern, um welche Art von bindbarer Eigenschaft es sich handelt (z. B. QProperty oder QObjectBindableProperty). In den meisten Anwendungsfällen sollte die Verwendung von ` QBindable<T>` (das generisch über die Eigenschaftsimplementierung ist, aber einen festen Typ hat) bevorzugt werden.

Dokumentation zu Mitgliedsfunktionen

[constexpr noexcept default] QUntypedBindable::QUntypedBindable()

Erzeugt standardmäßig ein `QUntypedBindable`. Es befindet sich in einem ungültigen Zustand.

Siehe auch isValid().

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

Erstellt ein `QUntypedBindable` aus der Eigenschaft ` property`. Ist `Property` ein Konstante, ist das `QUntypedBindable` schreibgeschützt. Ist ` property ` null, ist das `QUntypedBindable` ungültig.

Siehe auch „ isValid()“ und „ isReadOnly()“.

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

Ruft „ f “ als Änderungsbehandler auf. Immer wenn sich die zugrunde liegende Eigenschaft ändert, wird „ f “ aufgerufen, solange das zurückgegebene „ QPropertyNotifier “ und die Eigenschaft bestehen bleiben.

Diese Methode ist in manchen Fällen einfacher zu verwenden als ` onValueChanged()`, da das zurückgegebene Objekt kein Template ist. Es lässt sich daher leichter speichern, z. B. als Mitglied einer Klasse.

Siehe auch „ onValueChanged()“ und „ subscribe()“.

QUntypedPropertyBinding QUntypedBindable::binding() const

Gibt die Bindung der zugrunde liegenden Eigenschaft zurück, sofern vorhanden, andernfalls eine standardmäßig erstellte „ QUntypedPropertyBinding “.

Siehe auch ` setBinding()` und ` hasBinding()`.

bool QUntypedBindable::hasBinding() const

Gibt „ true “ zurück, wenn die zugrunde liegende Eigenschaft eine Bindung aufweist.

[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. Auf eine ungültige „ QUntypedBindable “ aufgerufene Methoden haben in der Regel 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, wobei ein angegebenes Quell location verwendet wird.

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

Gibt den Metatyp der Eigenschaft zurück, aus der das „ QUntypedBindable “ erstellt wurde. Ist das „Bindable“ ungültig, wird ein ungültiger Metatyp zurückgegeben.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch „ isValid()“ und „ QUntypedPropertyBinding::valueMetaType()“.

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

Ruft „ f “ als Änderungshandler auf. Immer wenn sich die zugrunde liegende Eigenschaft ändert, wird „ f “ aufgerufen, solange die zurückgegebene „ QPropertyChangeHandler “ und die Eigenschaft bestehen bleiben. Bei jeder Wertänderung wird der Handler je nach Kontext entweder sofort oder zeitversetzt aufgerufen.

Siehe auch QProperty::onValueChanged() und subscribe().

bool QUntypedBindable::setBinding(const QUntypedPropertyBinding &binding)

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

Gibt „ true “ zurück, wenn die Bindung erfolgreich festgelegt wurde.

Siehe auch „ binding()“ und „ QUntypedPropertyBinding::valueMetaType()“.

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 festgelegte Bindung von der Eigenschaft und gibt diese zurück. Gibt ein standardmäßig initialisiertes ` QUntypedPropertyBinding ` zurück, wenn keine Bindung festgelegt ist.

Diese Funktion wurde in Qt 6.1 eingeführt.

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