diff options
author | Topi Reinio <topi.reinio@qt.io> | 2020-11-19 22:58:31 +0100 |
---|---|---|
committer | Qt Cherry-pick Bot <cherrypick_bot@qt-project.org> | 2020-11-26 00:43:42 +0000 |
commit | 6c1b98da02ed499c86616badcf72773be7934793 (patch) | |
tree | 78f9d229cc846224a102743744aaf5477ab01362 /src | |
parent | 13b4328c2f41a41392aba60b09b2dbeffdf092e0 (diff) |
Doc: Document pooled(), reused() signals for ListView QML type
Change-Id: Ic8b2fa8333fdc6aae051f3b2faa3a0c0ecad9ad5
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
(cherry picked from commit d6a5a8525936ce3009ccbe8a68b7fbfa8e50b8ae)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
Diffstat (limited to 'src')
-rw-r--r-- | src/quick/items/qquicklistview.cpp | 33 |
1 files changed, 32 insertions, 1 deletions
diff --git a/src/quick/items/qquicklistview.cpp b/src/quick/items/qquicklistview.cpp index 139f6adfac..0c924c0e0e 100644 --- a/src/quick/items/qquicklistview.cpp +++ b/src/quick/items/qquicklistview.cpp @@ -2299,7 +2299,38 @@ QQuickListView::~QQuickListView() \since 5.15 - \sa {Reusing items}, ListView::pooled, ListView::reused + \sa {Reusing items}, pooled(), reused() +*/ + +/*! + \qmlattachedsignal QtQuick::ListView::pooled() + + This signal is emitted after an item has been added to the reuse + pool. You can use it to pause ongoing timers or animations inside + the item, or free up resources that cannot be reused. + + This signal is emitted only if the \l reuseItems property is \c true. + + \sa {Reusing items}, reuseItems, reused() +*/ + +/*! + \qmlattachedsignal QtQuick::ListView::reused() + + This signal is emitted after an item has been reused. At this point, the + item has been taken out of the pool and placed inside the content view, + and the model properties such as \c index and \c row have been updated. + + Other properties that are not provided by the model does not change when an + item is reused. You should avoid storing any state inside a delegate, but if + you do, manually reset that state on receiving this signal. + + This signal is emitted when the item is reused, and not the first time the + item is created. + + This signal is emitted only if the \l reuseItems property is \c true. + + \sa {Reusing items}, reuseItems, pooled() */ /*! |