summaryrefslogtreecommitdiff
path: root/src/location/places/qplacemanagerengine.cpp
diff options
context:
space:
mode:
authorabcd <amos.choy@nokia.com>2012-06-07 11:02:49 +1000
committerQt by Nokia <qt-info@nokia.com>2012-06-10 13:52:51 +0200
commit0c413b1780b6accadfffeea13be889a356567e94 (patch)
treee99295b810d3ca9dadc750190408a01a702354ee /src/location/places/qplacemanagerengine.cpp
parentb7aa1799b694a54d99f073b61389d4ca3501779a (diff)
downloadqtlocation-0c413b1780b6accadfffeea13be889a356567e94.tar.gz
dataChanged signal
The place and category added/modified/removed signals are not sufficient if there are large scale changes to the underlying datastore. To avoid potential avalanches of signals we have a dataChanged() signal for significant changes Change-Id: Ibb90c117eabfc6144ab5d8681bd9844575e86247 Reviewed-by: Aaron McCarthy <aaron.mccarthy@nokia.com>
Diffstat (limited to 'src/location/places/qplacemanagerengine.cpp')
-rw-r--r--src/location/places/qplacemanagerengine.cpp17
1 files changed, 16 insertions, 1 deletions
diff --git a/src/location/places/qplacemanagerengine.cpp b/src/location/places/qplacemanagerengine.cpp
index 4b71f9b4..f2a67d40 100644
--- a/src/location/places/qplacemanagerengine.cpp
+++ b/src/location/places/qplacemanagerengine.cpp
@@ -415,6 +415,7 @@ QPlaceManagerEnginePrivate::~QPlaceManagerEnginePrivate()
The particular added place is specified by \a placeId.
This signal is only emitted by manager engines that support the QPlaceManager::NotificationsFeature.
+ \sa dataChanged()
*/
/*!
@@ -424,6 +425,7 @@ QPlaceManagerEnginePrivate::~QPlaceManagerEnginePrivate()
The particular modified place is specified by \a placeId.
This signal is only emitted by manager engines that support the QPlaceManager::NotificationsFeature.
+ \sa dataChanged()
*/
/*!
@@ -433,6 +435,7 @@ QPlaceManagerEnginePrivate::~QPlaceManagerEnginePrivate()
The particular place that has been removed is specified by \a placeId.
This signal is only emitted by manager engines that support the QPlaceManager::NotificationsFeature.
+ \sa dataChanged()
*/
/*!
@@ -442,7 +445,7 @@ QPlaceManagerEnginePrivate::~QPlaceManagerEnginePrivate()
The parent of the \a category is specified by \a parentId.
This signal is only emitted by manager engines that support the QPlaceManager::NotificationsFeature.
-
+ \sa dataChanged()
*/
/*!
@@ -452,6 +455,7 @@ QPlaceManagerEnginePrivate::~QPlaceManagerEnginePrivate()
The parent of the modified category is specified by \a parentId.
This signal is only emitted by manager engines that support the QPlaceManager::NotificationsFeature.
+ \sa dataChanged()
*/
/*!
@@ -462,6 +466,17 @@ QPlaceManagerEnginePrivate::~QPlaceManagerEnginePrivate()
is specified by \a parentId.
This signal is only emitted by manager engines that support the QPlaceManager::NotificationsFeature.
+ \sa dataChanged()
+*/
+
+/*!
+ * \fn QPlaceManagerEngine::dataChanged()
+
+ This signal is emitted by the engine if there are large scale changes to its
+ underlying datastore and the engine considers these changes radical enough
+ to require clients to reload all data.
+
+ If the signal is emitted, no other signals will be emitted for the associated changes.
*/
QT_END_NAMESPACE