QBindable Class

Dokumentation der Mitgliedsfunktionen

[explicit] QBindable::QBindable(QObject *obj, const QMetaProperty &property)

Siehe QBindable::QBindable(QObject *obj, const char *property)

[explicit] QBindable::QBindable(QObject *obj, const char *property)

Konstruiert ein QBindable für die Q_PROPERTY property auf obj. Die Eigenschaft muss ein Benachrichtigungssignal haben, muss aber nicht BINDABLE in seiner Q_PROPERTY Definition haben, so dass auch bindungsunbewusste Q_PROPERTYs gebunden oder in Bindungsausdrücken verwendet werden können. Sie müssen QBindable::value() in Bindungsausdrücken anstelle der normalen Eigenschaft READ Funktion (oder MEMBER) verwenden, um die Abhängigkeitsverfolgung zu aktivieren, wenn die Eigenschaft nicht BINDABLE ist. Beim Binden mit einem Lambda können Sie es vorziehen, das QBindable durch einen Wert zu erfassen, um die Kosten für den Aufruf dieses Konstruktors im Bindungsausdruck zu vermeiden. Dieser Konstruktor sollte nicht verwendet werden, um BINDABLE für eine Q_PROPERTY zu implementieren, da die resultierende Q_PROPERTY keine Abhängigkeitsverfolgung unterstützt. Um eine Eigenschaft zu erstellen, die direkt verwendbar ist, ohne ein QBindable zu lesen, verwenden Sie QProperty oder QObjectBindableProperty.

QProperty<QString> displayText;
QDateTimeEdit *dateTimeEdit = findDateTimeEdit();
QBindable<QDateTime> dateTimeBindable(dateTimeEdit, "dateTime");
displayText.setBinding([dateTimeBindable](){ return dateTimeBindable.value().toString(); });

Siehe auch QProperty, QObjectBindableProperty, und Qt Bindable Properties.

QPropertyBinding<T> QBindable::binding() const

Gibt die aktuell eingestellte Bindung der zugrunde liegenden Eigenschaft zurück. Wenn die Eigenschaft keine Bindung hat, ist die zurückgegebene QPropertyBinding<T> ungültig.

Siehe auch setBinding und hasBinding.

QPropertyBinding<T> QBindable::makeBinding(const QPropertyBindingSourceLocation &location = QT_PROPERTY_DEFAULT_BINDING_LOCATION) const

Konstruiert eine Bindung, die den Wert der zugrunde liegenden Eigenschaft auswertet, unter Verwendung einer angegebenen Quelle location.

QPropertyBinding<T> QBindable::setBinding(const QPropertyBinding<T> &binding)

Setzt die Bindung der zugrunde liegenden Eigenschaft auf binding. Führt nichts aus, wenn die QBindable schreibgeschützt oder ungültig ist.

Siehe auch binding, isReadOnly(), und isValid().

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

Dies ist eine überladene Funktion.

Erzeugt eine QPropertyBinding<T> aus f und legt sie als Bindung für die zugrunde liegende Eigenschaft fest.

void QBindable::setValue(const T &value)

Setzt den Wert der zugrundeliegenden Eigenschaft auf value. Dadurch wird jede aktuell gesetzte Bindung aufgehoben. Diese Funktion hat keine Auswirkung, wenn die QBindable schreibgeschützt oder ungültig ist.

Siehe auch value(), isValid(), isReadOnly(), und setBinding().

QPropertyBinding<T> QBindable::takeBinding()

Entfernt die aktuell eingestellte Bindung der zugrunde liegenden Eigenschaft und gibt sie zurück. Wenn die Eigenschaft keine Bindung hat, ist die zurückgegebene QPropertyBinding<T> ungültig.

Siehe auch binding, setBinding, und hasBinding.

T QBindable::value() const

Gibt den aktuellen Wert der zugrunde liegenden Eigenschaft zurück. Wenn QBindable ungültig ist, wird ein konstruierter Standardwert T zurückgegeben.

Siehe auch setValue() und isValid().