qfuturewatcher.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:6k
- /****************************************************************************
- **
- ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
- ** Contact: Qt Software Information (qt-info@nokia.com)
- **
- ** This file is part of the QtCore module of the Qt Toolkit.
- **
- ** Commercial Usage
- ** Licensees holding valid Qt Commercial licenses may use this file in
- ** accordance with the Qt Commercial License Agreement provided with the
- ** Software or, alternatively, in accordance with the terms contained in
- ** a written agreement between you and Nokia.
- **
- **
- ** GNU General Public License Usage
- ** Alternatively, this file may be used under the terms of the GNU
- ** General Public License versions 2.0 or 3.0 as published by the Free
- ** Software Foundation and appearing in the file LICENSE.GPL included in
- ** the packaging of this file. Please review the following information
- ** to ensure GNU General Public Licensing requirements will be met:
- ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
- ** http://www.gnu.org/copyleft/gpl.html. In addition, as a special
- ** exception, Nokia gives you certain additional rights. These rights
- ** are described in the Nokia Qt GPL Exception version 1.3, included in
- ** the file GPL_EXCEPTION.txt in this package.
- **
- ** Qt for Windows(R) Licensees
- ** As a special exception, Nokia, as the sole copyright holder for Qt
- ** Designer, grants users of the Qt/Eclipse Integration plug-in the
- ** right for the Qt/Eclipse Integration to link to functionality
- ** provided by Qt Designer and its related libraries.
- **
- ** If you are unsure which license is appropriate for your use, please
- ** contact the sales department at qt-sales@nokia.com.
- **
- ****************************************************************************/
- #ifndef QFUTUREWATCHER_H
- #define QFUTUREWATCHER_H
- #include <QtCore/qfuture.h>
- #ifndef QT_NO_QFUTURE
- #include <QtCore/qobject.h>
- QT_BEGIN_HEADER
- QT_BEGIN_NAMESPACE
- QT_MODULE(Core)
- class QEvent;
- class QFutureWatcherBasePrivate;
- class Q_CORE_EXPORT QFutureWatcherBase : public QObject
- {
- Q_OBJECT
- Q_DECLARE_PRIVATE(QFutureWatcherBase)
- public:
- QFutureWatcherBase(QObject *parent = 0);
- int progressValue() const;
- int progressMinimum() const;
- int progressMaximum() const;
- QString progressText() const;
- bool isStarted() const;
- bool isFinished() const;
- bool isRunning() const;
- bool isCanceled() const;
- bool isPaused() const;
- void waitForFinished();
- void setPendingResultsLimit(int limit);
- bool event(QEvent *event);
- Q_SIGNALS:
- void started();
- void finished();
- void canceled();
- void paused();
- void resumed();
- void resultReadyAt(int resultIndex);
- void resultsReadyAt(int beginIndex, int endIndex);
- void progressRangeChanged(int minimum, int maximum);
- void progressValueChanged(int progressValue);
- void progressTextChanged(const QString &progressText);
- public Q_SLOTS:
- void cancel();
- void setPaused(bool paused);
- void pause();
- void resume();
- void togglePaused();
- protected:
- void connectNotify (const char * signal);
- void disconnectNotify (const char * signal);
- // called from setFuture() implemented in template sub-classes
- void connectOutputInterface();
- void disconnectOutputInterface(bool pendingAssignment = false);
- private:
- // implemented in the template sub-classes
- virtual const QFutureInterfaceBase &futureInterface() const = 0;
- virtual QFutureInterfaceBase &futureInterface() = 0;
- };
- template <typename T>
- class QFutureWatcher : public QFutureWatcherBase
- {
- public:
- QFutureWatcher(QObject *_parent = 0)
- : QFutureWatcherBase(_parent)
- { }
- ~QFutureWatcher()
- { disconnectOutputInterface(); }
- void setFuture(const QFuture<T> &future);
- QFuture<T> future() const
- { return m_future; }
- T result() const { return m_future.result(); }
- T resultAt(int index) const { return m_future.resultAt(index); }
- #ifdef qdoc
- int progressValue() const;
- int progressMinimum() const;
- int progressMaximum() const;
- QString progressText() const;
- bool isStarted() const;
- bool isFinished() const;
- bool isRunning() const;
- bool isCanceled() const;
- bool isPaused() const;
- void waitForFinished();
- void setPendingResultsLimit(int limit);
- Q_SIGNALS:
- void started();
- void finished();
- void canceled();
- void paused();
- void resumed();
- void resultReadyAt(int resultIndex);
- void resultsReadyAt(int beginIndex, int endIndex);
- void progressRangeChanged(int minimum, int maximum);
- void progressValueChanged(int progressValue);
- void progressTextChanged(const QString &progressText);
- public Q_SLOTS:
- void cancel();
- void setPaused(bool paused);
- void pause();
- void resume();
- void togglePaused();
- #endif
- private:
- QFuture<T> m_future;
- const QFutureInterfaceBase &futureInterface() const { return m_future.d; }
- QFutureInterfaceBase &futureInterface() { return m_future.d; }
- };
- template <typename T>
- Q_INLINE_TEMPLATE void QFutureWatcher<T>::setFuture(const QFuture<T> &_future)
- {
- if (_future == m_future)
- return;
- disconnectOutputInterface(true);
- m_future = _future;
- connectOutputInterface();
- }
- template <>
- class QFutureWatcher<void> : public QFutureWatcherBase
- {
- public:
- QFutureWatcher(QObject *_parent = 0)
- : QFutureWatcherBase(_parent)
- { }
- ~QFutureWatcher()
- { disconnectOutputInterface(); }
- void setFuture(const QFuture<void> &future);
- QFuture<void> future() const
- { return m_future; }
- private:
- QFuture<void> m_future;
- const QFutureInterfaceBase &futureInterface() const { return m_future.d; }
- QFutureInterfaceBase &futureInterface() { return m_future.d; }
- };
- Q_INLINE_TEMPLATE void QFutureWatcher<void>::setFuture(const QFuture<void> &_future)
- {
- if (_future == m_future)
- return;
- disconnectOutputInterface(true);
- m_future = _future;
- connectOutputInterface();
- }
- QT_END_NAMESPACE
- QT_END_HEADER
- #endif // QT_NO_CONCURRENT
- #endif // QFUTUREWATCHER_H