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>
This commit is contained in:
Andreas Buhr 2021-02-02 10:17:12 +01:00
parent d197ad0e2a
commit edcb5ed697

View File

@ -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