summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--src/corelib/kernel/qproperty.cpp11
1 files changed, 11 insertions, 0 deletions
diff --git a/src/corelib/kernel/qproperty.cpp b/src/corelib/kernel/qproperty.cpp
index 482ed3bf35..a635cb8afc 100644
--- a/src/corelib/kernel/qproperty.cpp
+++ b/src/corelib/kernel/qproperty.cpp
@@ -1175,6 +1175,17 @@ QString QPropertyBindingError::description() const
dynamically, the binding expression. It is represented as a C++ lambda and
can be used to express relationships between different properties in your
application.
+
+ \note In the case of QML it is important that \l QProperty needs to be exposed
+ in \l Q_PROPERTY with the BINDABLE keyword. As a result the QML engine, uses it
+ as the bindable interface to set up the property binding. In turn, the binding
+ can be then interacted with C++ via the normal API like:
+
+ QProperty<T>::onValueChanged, QProperty::takeBinding and QBindable::hasBinding
+
+ If the property is BINDABLE, then the engine will use the change-tracking
+ inherent to the C++ property system for getting notified about changes; and
+ won't rely on signals being emitted.
*/
/*!