From edcb5ed697f4b56d0923898f7ce4ff6fbbf55a36 Mon Sep 17 00:00:00 2001 From: Andreas Buhr Date: Tue, 2 Feb 2021 10:17:12 +0100 Subject: 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 Reviewed-by: Fabian Kosmale --- src/corelib/doc/src/objectmodel/bindableproperties.qdoc | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'src/corelib/doc') 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 -- cgit v1.2.3