summaryrefslogtreecommitdiffstats
path: root/src/corelib/doc/src/objectmodel/bindableproperties.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'src/corelib/doc/src/objectmodel/bindableproperties.qdoc')
-rw-r--r--src/corelib/doc/src/objectmodel/bindableproperties.qdoc14
1 files changed, 14 insertions, 0 deletions
diff --git a/src/corelib/doc/src/objectmodel/bindableproperties.qdoc b/src/corelib/doc/src/objectmodel/bindableproperties.qdoc
index dc83c01e3d..391ce4baf7 100644
--- a/src/corelib/doc/src/objectmodel/bindableproperties.qdoc
+++ b/src/corelib/doc/src/objectmodel/bindableproperties.qdoc
@@ -45,6 +45,20 @@
uses the encapsulating QObject to store the pointer to the
management data structure.
+ \section1 Why Use Bindable Properties?
+
+ Property bindings are one of the core features of QML. They allow to specify
+ relationships between different object properties and automatically update
+ properties' values whenever their dependencies change. Bindable properties
+ allow to achieve the same not only in QML code, but also in C++. Using
+ bindable properties can help to simplify your program, by eliminating a lot
+ of boilerplate code for tracking and reacting to dependency updates of
+ different objects.
+
+ The \l {Introductory Example} below demonstrates the usage of bindable
+ properties in C++ code. You can also check \l {Bindable Properties Example}
+ to see how the bindable properties can help to improve your code.
+
\section1 Introductory Example
The binding expression computes the value by reading other QProperty values.