aboutsummaryrefslogtreecommitdiffstats
path: root/src/quicktemplates/qquickdeferredexecute.cpp
diff options
context:
space:
mode:
authorTarja Sundqvist <tarja.sundqvist@qt.io>2025-12-15 16:14:22 +0200
committerTarja Sundqvist <tarja.sundqvist@qt.io>2025-12-15 16:14:22 +0200
commitb58ec3b086518da5aa573f99426235854c23e35f (patch)
tree861a9935d8f1cdba2fdca546836a351736dbddbf /src/quicktemplates/qquickdeferredexecute.cpp
parent4826f86e274f1b29bd769e6790824f9e62a40f62 (diff)
parent22032227d16c39211e2ebceef97d21f4d89c7c87 (diff)
Merge tag 'v6.5.8-lts-lgpl' into 6.56.5
Qt 6.5.8-lts-lgpl release
Diffstat (limited to 'src/quicktemplates/qquickdeferredexecute.cpp')
-rw-r--r--src/quicktemplates/qquickdeferredexecute.cpp25
1 files changed, 25 insertions, 0 deletions
diff --git a/src/quicktemplates/qquickdeferredexecute.cpp b/src/quicktemplates/qquickdeferredexecute.cpp
index 239b0fa6a6..8e63ae2188 100644
--- a/src/quicktemplates/qquickdeferredexecute.cpp
+++ b/src/quicktemplates/qquickdeferredexecute.cpp
@@ -13,6 +13,31 @@
QT_BEGIN_NAMESPACE
+/*!
+ \internal
+
+ For the history behind why these functions were introduced, see
+ the comments of QTBUG-50992, specifically
+ \l {https://bugreports.qt.io/browse/QTBUG-50992?focusedId=325677&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-325677}{this}.
+
+ The first commit to the QML engine to support deferred properties seems to
+ be 59b8d719d6122d86a4cc650911788cc4d778ce29.
+
+ The first commit to add support for it in Controls was
+ 458eb65f730178bc93ba7b18f0e4dd2a13efad2e.
+
+ In short, deferred execution solved two issues:
+
+ \list 1
+ \li Incubation issues when using asynchronous loaders, AKA QTBUG-50992.
+ \li Performance issues from creating two items unnecessarily when a
+ styled control was customized, which is explained in more detail
+ in the commit message of 458eb65f730178bc93ba7b18f0e4dd2a13efad2e.
+ \endlist
+
+ \sa qmlExecuteDeferred
+*/
+
namespace QtQuickPrivate {
static void cancelDeferred(QQmlData *ddata, int propertyIndex)