QDeclarativePositionSource::update() - add timeout parameter

Was planned for Qt6. The default value is 0, which does not change the
existing code's behavior.

Task-number: QTBUG-90491
Change-Id: I7db180b0bd9fffe2becab03f9f3c9e7ebc73cb05
Reviewed-by: Alex Blasche <alexander.blasche@qt.io>

2 files changed, 8 insertions, 4 deletions

diff --git a/src/positioningquick/qdeclarativepositionsource.cpp b/src/positioningquick/qdeclarativepositionsource.cpp
index f3b64b66..0679e62c 100644
--- a/src/positioningquick/qdeclarativepositionsource.cpp
+++ b/src/positioningquick/qdeclarativepositionsource.cpp
@@ -636,7 +636,7 @@ void QDeclarativePositionSource::start()
 }
 
 /*!
-    \qmlmethod PositionSource::update()
+    \qmlmethod PositionSource::update(int timeout)
 
     A convenience method to request single update from the location source.
     If there is no source available, this method has no effect.
@@ -645,10 +645,14 @@ void QDeclarativePositionSource::start()
     long as it takes to receive an update, or until the request times
     out.  The request timeout period is source-specific.
 
+    The \a timeout is specified in milliseconds. If the \a timeout is zero
+    (the default value), it defaults to a reasonable timeout period as
+    appropriate for the source.
+
     \sa start, stop, active
 */
 
-void QDeclarativePositionSource::update()
+void QDeclarativePositionSource::update(int timeout)
 {
     if (m_positionSource) {
         if (!m_active) {
@@ -659,7 +663,7 @@ void QDeclarativePositionSource::update()
         // Use default timeout value. Set active before calling the
         // update request because on some platforms there may
         // be results immediately.
-        m_positionSource->requestUpdate();
+        m_positionSource->requestUpdate(timeout);
     }
 }
 
diff --git a/src/positioningquick/qdeclarativepositionsource_p.h b/src/positioningquick/qdeclarativepositionsource_p.h
index 96bc69f8..8fe645f1 100644
--- a/src/positioningquick/qdeclarativepositionsource_p.h
+++ b/src/positioningquick/qdeclarativepositionsource_p.h
@@ -136,7 +136,7 @@ public:
     Q_REVISION(14) Q_INVOKABLE QVariant backendProperty(const QString &name) const;
 
 public Q_SLOTS:
-    void update(); // TODO Qt 6 change to void update(int)
+    void update(int timeout = 0);
     void start();
     void stop();