summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndreas Buhr <andreas.buhr@qt.io>2021-02-02 10:17:12 +0100
committerAndreas Buhr <andreas.buhr@qt.io>2021-04-13 23:41:45 +0200
commitedcb5ed697f4b56d0923898f7ce4ff6fbbf55a36 (patch)
tree7694c8820c77168f1b740dfd881ac3ab61c2ab38
parentd197ad0e2ad55a5b39f9b34482794b8a57dcc7ad (diff)
Document how bindable properties can be used in a multithreaded context
Add documentation which specifies that bindable properties cannot be used in a multithreaded context. Actually, they can be read when the owning thread is suspended completely, but this should only be used by Qt internally. Task-number: QTBUG-90511 Change-Id: I87effac3aea35205f05151cba3c95816da9a5c9d Reviewed-by: Lars Knoll <lars.knoll@qt.io> Reviewed-by: Fabian Kosmale <fabian.kosmale@qt.io>
-rw-r--r--src/corelib/doc/src/objectmodel/bindableproperties.qdoc6
1 files changed, 6 insertions, 0 deletions
diff --git a/src/corelib/doc/src/objectmodel/bindableproperties.qdoc b/src/corelib/doc/src/objectmodel/bindableproperties.qdoc
index 6e63481c14..8b50c65d7c 100644
--- a/src/corelib/doc/src/objectmodel/bindableproperties.qdoc
+++ b/src/corelib/doc/src/objectmodel/bindableproperties.qdoc
@@ -207,6 +207,12 @@
Functions used as bindings as well as all code which is called inside a binding
must not co_await. Doing so can confuse the property system's tracking of dependencies.
+ \section1 Bindable Properties and Multithreading
+
+ Bindable properties are not threadsafe, unless stated otherwise.
+ A bindable property must not be read or modified by any thread other than
+ the one is was created in.
+
\section1 Tracking Bindable Properties
Sometimes the relationships between properties cannot be expressed using