qfuturewatcher.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:6k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtCore module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QFUTUREWATCHER_H
  38. #define QFUTUREWATCHER_H
  39. #include <QtCore/qfuture.h>
  40. #ifndef QT_NO_QFUTURE
  41. #include <QtCore/qobject.h>
  42. QT_BEGIN_HEADER
  43. QT_BEGIN_NAMESPACE
  44. QT_MODULE(Core)
  45. class QEvent;
  46. class QFutureWatcherBasePrivate;
  47. class Q_CORE_EXPORT QFutureWatcherBase : public QObject
  48. {
  49.     Q_OBJECT
  50.     Q_DECLARE_PRIVATE(QFutureWatcherBase)
  51. public:
  52.     QFutureWatcherBase(QObject *parent = 0);
  53.     int progressValue() const;
  54.     int progressMinimum() const;
  55.     int progressMaximum() const;
  56.     QString progressText() const;
  57.     bool isStarted() const;
  58.     bool isFinished() const;
  59.     bool isRunning() const;
  60.     bool isCanceled() const;
  61.     bool isPaused() const;
  62.     void waitForFinished();
  63.     void setPendingResultsLimit(int limit);
  64.     bool event(QEvent *event);
  65. Q_SIGNALS:
  66.     void started();
  67.     void finished();
  68.     void canceled();
  69.     void paused();
  70.     void resumed();
  71.     void resultReadyAt(int resultIndex);
  72.     void resultsReadyAt(int beginIndex, int endIndex);
  73.     void progressRangeChanged(int minimum, int maximum);
  74.     void progressValueChanged(int progressValue);
  75.     void progressTextChanged(const QString &progressText);
  76. public Q_SLOTS:
  77.     void cancel();
  78.     void setPaused(bool paused);
  79.     void pause();
  80.     void resume();
  81.     void togglePaused();
  82. protected:
  83.     void connectNotify (const char * signal);
  84.     void disconnectNotify (const char * signal);
  85.     // called from setFuture() implemented in template sub-classes
  86.     void connectOutputInterface();
  87.     void disconnectOutputInterface(bool pendingAssignment = false);
  88. private:
  89.     // implemented in the template sub-classes
  90.     virtual const QFutureInterfaceBase &futureInterface() const = 0;
  91.     virtual QFutureInterfaceBase &futureInterface() = 0;
  92. };
  93. template <typename T>
  94. class QFutureWatcher : public QFutureWatcherBase
  95. {
  96. public:
  97.     QFutureWatcher(QObject *_parent = 0)
  98.         : QFutureWatcherBase(_parent)
  99.     { }
  100.     ~QFutureWatcher()
  101.     { disconnectOutputInterface(); }
  102.     void setFuture(const QFuture<T> &future);
  103.     QFuture<T> future() const
  104.     { return m_future; }
  105.     T result() const { return m_future.result(); }
  106.     T resultAt(int index) const { return m_future.resultAt(index); }
  107. #ifdef qdoc
  108.     int progressValue() const;
  109.     int progressMinimum() const;
  110.     int progressMaximum() const;
  111.     QString progressText() const;
  112.     bool isStarted() const;
  113.     bool isFinished() const;
  114.     bool isRunning() const;
  115.     bool isCanceled() const;
  116.     bool isPaused() const;
  117.     void waitForFinished();
  118.     void setPendingResultsLimit(int limit);
  119. Q_SIGNALS:
  120.     void started();
  121.     void finished();
  122.     void canceled();
  123.     void paused();
  124.     void resumed();
  125.     void resultReadyAt(int resultIndex);
  126.     void resultsReadyAt(int beginIndex, int endIndex);
  127.     void progressRangeChanged(int minimum, int maximum);
  128.     void progressValueChanged(int progressValue);
  129.     void progressTextChanged(const QString &progressText);
  130. public Q_SLOTS:
  131.     void cancel();
  132.     void setPaused(bool paused);
  133.     void pause();
  134.     void resume();
  135.     void togglePaused();
  136. #endif
  137. private:
  138.     QFuture<T> m_future;
  139.     const QFutureInterfaceBase &futureInterface() const { return m_future.d; }
  140.     QFutureInterfaceBase &futureInterface() { return m_future.d; }
  141. };
  142. template <typename T>
  143. Q_INLINE_TEMPLATE void QFutureWatcher<T>::setFuture(const QFuture<T> &_future)
  144. {
  145.     if (_future == m_future)
  146.         return;
  147.     disconnectOutputInterface(true);
  148.     m_future = _future;
  149.     connectOutputInterface();
  150. }
  151. template <>
  152. class QFutureWatcher<void> : public QFutureWatcherBase
  153. {
  154. public:
  155.     QFutureWatcher(QObject *_parent = 0)
  156.         : QFutureWatcherBase(_parent)
  157.     { }
  158.     ~QFutureWatcher()
  159.     { disconnectOutputInterface(); }
  160.     void setFuture(const QFuture<void> &future);
  161.     QFuture<void> future() const
  162.     { return m_future; }
  163. private:
  164.     QFuture<void> m_future;
  165.     const QFutureInterfaceBase &futureInterface() const { return m_future.d; }
  166.     QFutureInterfaceBase &futureInterface() { return m_future.d; }
  167. };
  168. Q_INLINE_TEMPLATE void QFutureWatcher<void>::setFuture(const QFuture<void> &_future)
  169. {
  170.     if (_future == m_future)
  171.         return;
  172.     disconnectOutputInterface(true);
  173.     m_future = _future;
  174.     connectOutputInterface();
  175. }
  176. QT_END_NAMESPACE
  177. QT_END_HEADER
  178. #endif // QT_NO_CONCURRENT
  179. #endif // QFUTUREWATCHER_H