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: |
Ö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.