Absolute File Name: | /home/qt/qt5_coco/qt5/qtbase/src/widgets/dialogs/qprogressdialog.cpp |
Source code | Switch to Preprocessed file |
Line | Source | Count | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | /**************************************************************************** | - | ||||||||||||||||||
2 | ** | - | ||||||||||||||||||
3 | ** Copyright (C) 2015 The Qt Company Ltd. | - | ||||||||||||||||||
4 | ** Contact: http://www.qt.io/licensing/ | - | ||||||||||||||||||
5 | ** | - | ||||||||||||||||||
6 | ** This file is part of the QtWidgets module of the Qt Toolkit. | - | ||||||||||||||||||
7 | ** | - | ||||||||||||||||||
8 | ** $QT_BEGIN_LICENSE:LGPL21$ | - | ||||||||||||||||||
9 | ** Commercial License Usage | - | ||||||||||||||||||
10 | ** Licensees holding valid commercial Qt licenses may use this file in | - | ||||||||||||||||||
11 | ** accordance with the commercial license agreement provided with the | - | ||||||||||||||||||
12 | ** Software or, alternatively, in accordance with the terms contained in | - | ||||||||||||||||||
13 | ** a written agreement between you and The Qt Company. For licensing terms | - | ||||||||||||||||||
14 | ** and conditions see http://www.qt.io/terms-conditions. For further | - | ||||||||||||||||||
15 | ** information use the contact form at http://www.qt.io/contact-us. | - | ||||||||||||||||||
16 | ** | - | ||||||||||||||||||
17 | ** GNU Lesser General Public License Usage | - | ||||||||||||||||||
18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - | ||||||||||||||||||
19 | ** General Public License version 2.1 or version 3 as published by the Free | - | ||||||||||||||||||
20 | ** Software Foundation and appearing in the file LICENSE.LGPLv21 and | - | ||||||||||||||||||
21 | ** LICENSE.LGPLv3 included in the packaging of this file. Please review the | - | ||||||||||||||||||
22 | ** following information to ensure the GNU Lesser General Public License | - | ||||||||||||||||||
23 | ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and | - | ||||||||||||||||||
24 | ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | - | ||||||||||||||||||
25 | ** | - | ||||||||||||||||||
26 | ** As a special exception, The Qt Company gives you certain additional | - | ||||||||||||||||||
27 | ** rights. These rights are described in The Qt Company LGPL Exception | - | ||||||||||||||||||
28 | ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | - | ||||||||||||||||||
29 | ** | - | ||||||||||||||||||
30 | ** $QT_END_LICENSE$ | - | ||||||||||||||||||
31 | ** | - | ||||||||||||||||||
32 | ****************************************************************************/ | - | ||||||||||||||||||
33 | - | |||||||||||||||||||
34 | #include "qprogressdialog.h" | - | ||||||||||||||||||
35 | - | |||||||||||||||||||
36 | #ifndef QT_NO_PROGRESSDIALOG | - | ||||||||||||||||||
37 | - | |||||||||||||||||||
38 | #include "qshortcut.h" | - | ||||||||||||||||||
39 | #include "qpainter.h" | - | ||||||||||||||||||
40 | #include "qdrawutil.h" | - | ||||||||||||||||||
41 | #include "qlabel.h" | - | ||||||||||||||||||
42 | #include "qprogressbar.h" | - | ||||||||||||||||||
43 | #include "qapplication.h" | - | ||||||||||||||||||
44 | #include "qstyle.h" | - | ||||||||||||||||||
45 | #include "qpushbutton.h" | - | ||||||||||||||||||
46 | #include "qcursor.h" | - | ||||||||||||||||||
47 | #include "qtimer.h" | - | ||||||||||||||||||
48 | #include "qelapsedtimer.h" | - | ||||||||||||||||||
49 | #include <private/qdialog_p.h> | - | ||||||||||||||||||
50 | #include <limits.h> | - | ||||||||||||||||||
51 | - | |||||||||||||||||||
52 | QT_BEGIN_NAMESPACE | - | ||||||||||||||||||
53 | - | |||||||||||||||||||
54 | // If the operation is expected to take this long (as predicted by | - | ||||||||||||||||||
55 | // progress time), show the progress dialog. | - | ||||||||||||||||||
56 | static const int defaultShowTime = 4000; | - | ||||||||||||||||||
57 | // Wait at least this long before attempting to make a prediction. | - | ||||||||||||||||||
58 | static const int minWaitTime = 50; | - | ||||||||||||||||||
59 | - | |||||||||||||||||||
60 | class QProgressDialogPrivate : public QDialogPrivate | - | ||||||||||||||||||
61 | { | - | ||||||||||||||||||
62 | Q_DECLARE_PUBLIC(QProgressDialog) | - | ||||||||||||||||||
63 | - | |||||||||||||||||||
64 | public: | - | ||||||||||||||||||
65 | QProgressDialogPrivate() : label(0), cancel(0), bar(0), | - | ||||||||||||||||||
66 | shown_once(false), | - | ||||||||||||||||||
67 | cancellation_flag(false), | - | ||||||||||||||||||
68 | setValue_called(false), | - | ||||||||||||||||||
69 | showTime(defaultShowTime), | - | ||||||||||||||||||
70 | #ifndef QT_NO_SHORTCUT | - | ||||||||||||||||||
71 | escapeShortcut(0), | - | ||||||||||||||||||
72 | #endif | - | ||||||||||||||||||
73 | useDefaultCancelText(false) | - | ||||||||||||||||||
74 | { | - | ||||||||||||||||||
75 | } never executed: end of block | 0 | ||||||||||||||||||
76 | - | |||||||||||||||||||
77 | void init(const QString &labelText, const QString &cancelText, int min, int max); | - | ||||||||||||||||||
78 | void layout(); | - | ||||||||||||||||||
79 | void retranslateStrings(); | - | ||||||||||||||||||
80 | void setCancelButtonText(const QString &cancelButtonText); | - | ||||||||||||||||||
81 | void adoptChildWidget(QWidget *c); | - | ||||||||||||||||||
82 | void ensureSizeIsAtLeastSizeHint(); | - | ||||||||||||||||||
83 | void _q_disconnectOnClose(); | - | ||||||||||||||||||
84 | - | |||||||||||||||||||
85 | QLabel *label; | - | ||||||||||||||||||
86 | QPushButton *cancel; | - | ||||||||||||||||||
87 | QProgressBar *bar; | - | ||||||||||||||||||
88 | QTimer *forceTimer; | - | ||||||||||||||||||
89 | bool shown_once; | - | ||||||||||||||||||
90 | bool cancellation_flag; | - | ||||||||||||||||||
91 | bool setValue_called; | - | ||||||||||||||||||
92 | QElapsedTimer starttime; | - | ||||||||||||||||||
93 | #ifndef QT_NO_CURSOR | - | ||||||||||||||||||
94 | QCursor parentCursor; | - | ||||||||||||||||||
95 | #endif | - | ||||||||||||||||||
96 | int showTime; | - | ||||||||||||||||||
97 | bool autoClose; | - | ||||||||||||||||||
98 | bool autoReset; | - | ||||||||||||||||||
99 | bool forceHide; | - | ||||||||||||||||||
100 | #ifndef QT_NO_SHORTCUT | - | ||||||||||||||||||
101 | QShortcut *escapeShortcut; | - | ||||||||||||||||||
102 | #endif | - | ||||||||||||||||||
103 | bool useDefaultCancelText; | - | ||||||||||||||||||
104 | QPointer<QObject> receiverToDisconnectOnClose; | - | ||||||||||||||||||
105 | QByteArray memberToDisconnectOnClose; | - | ||||||||||||||||||
106 | }; | - | ||||||||||||||||||
107 | - | |||||||||||||||||||
108 | void QProgressDialogPrivate::init(const QString &labelText, const QString &cancelText, | - | ||||||||||||||||||
109 | int min, int max) | - | ||||||||||||||||||
110 | { | - | ||||||||||||||||||
111 | Q_Q(QProgressDialog); | - | ||||||||||||||||||
112 | label = new QLabel(labelText, q); | - | ||||||||||||||||||
113 | bar = new QProgressBar(q); | - | ||||||||||||||||||
114 | bar->setRange(min, max); | - | ||||||||||||||||||
115 | int align = q->style()->styleHint(QStyle::SH_ProgressDialog_TextLabelAlignment, 0, q); | - | ||||||||||||||||||
116 | label->setAlignment(Qt::Alignment(align)); | - | ||||||||||||||||||
117 | autoClose = true; | - | ||||||||||||||||||
118 | autoReset = true; | - | ||||||||||||||||||
119 | forceHide = false; | - | ||||||||||||||||||
120 | QObject::connect(q, SIGNAL(canceled()), q, SLOT(cancel())); | - | ||||||||||||||||||
121 | forceTimer = new QTimer(q); | - | ||||||||||||||||||
122 | QObject::connect(forceTimer, SIGNAL(timeout()), q, SLOT(forceShow())); | - | ||||||||||||||||||
123 | if (useDefaultCancelText) {
| 0 | ||||||||||||||||||
124 | retranslateStrings(); | - | ||||||||||||||||||
125 | } else { never executed: end of block | 0 | ||||||||||||||||||
126 | q->setCancelButtonText(cancelText); | - | ||||||||||||||||||
127 | } never executed: end of block | 0 | ||||||||||||||||||
128 | starttime.start(); | - | ||||||||||||||||||
129 | forceTimer->start(showTime); | - | ||||||||||||||||||
130 | } never executed: end of block | 0 | ||||||||||||||||||
131 | - | |||||||||||||||||||
132 | void QProgressDialogPrivate::layout() | - | ||||||||||||||||||
133 | { | - | ||||||||||||||||||
134 | Q_Q(QProgressDialog); | - | ||||||||||||||||||
135 | int sp = q->style()->pixelMetric(QStyle::PM_DefaultLayoutSpacing); | - | ||||||||||||||||||
136 | int mtb = q->style()->pixelMetric(QStyle::PM_DefaultTopLevelMargin); | - | ||||||||||||||||||
137 | int mlr = qMin(q->width() / 10, mtb); | - | ||||||||||||||||||
138 | const bool centered = | - | ||||||||||||||||||
139 | bool(q->style()->styleHint(QStyle::SH_ProgressDialog_CenterCancelButton, 0, q)); | - | ||||||||||||||||||
140 | - | |||||||||||||||||||
141 | int additionalSpacing = 0; | - | ||||||||||||||||||
142 | QSize cs = cancel ? cancel->sizeHint() : QSize(0,0);
| 0 | ||||||||||||||||||
143 | QSize bh = bar->sizeHint(); | - | ||||||||||||||||||
144 | int cspc; | - | ||||||||||||||||||
145 | int lh = 0; | - | ||||||||||||||||||
146 | - | |||||||||||||||||||
147 | // Find spacing and sizes that fit. It is important that a progress | - | ||||||||||||||||||
148 | // dialog can be made very small if the user demands it so. | - | ||||||||||||||||||
149 | for (int attempt=5; attempt--;) {
| 0 | ||||||||||||||||||
150 | cspc = cancel ? cs.height() + sp : 0;
| 0 | ||||||||||||||||||
151 | lh = qMax(0, q->height() - mtb - bh.height() - sp - cspc); | - | ||||||||||||||||||
152 | - | |||||||||||||||||||
153 | if (lh < q->height()/4) {
| 0 | ||||||||||||||||||
154 | // Getting cramped | - | ||||||||||||||||||
155 | sp /= 2; | - | ||||||||||||||||||
156 | mtb /= 2; | - | ||||||||||||||||||
157 | if (cancel) {
| 0 | ||||||||||||||||||
158 | cs.setHeight(qMax(4,cs.height()-sp-2)); | - | ||||||||||||||||||
159 | } never executed: end of block | 0 | ||||||||||||||||||
160 | bh.setHeight(qMax(4,bh.height()-sp-1)); | - | ||||||||||||||||||
161 | } else { never executed: end of block | 0 | ||||||||||||||||||
162 | break; never executed: break; | 0 | ||||||||||||||||||
163 | } | - | ||||||||||||||||||
164 | } | - | ||||||||||||||||||
165 | - | |||||||||||||||||||
166 | if (cancel) {
| 0 | ||||||||||||||||||
167 | cancel->setGeometry( | - | ||||||||||||||||||
168 | centered ? q->width()/2 - cs.width()/2 : q->width() - mlr - cs.width(), | - | ||||||||||||||||||
169 | q->height() - mtb - cs.height(), | - | ||||||||||||||||||
170 | cs.width(), cs.height()); | - | ||||||||||||||||||
171 | } never executed: end of block | 0 | ||||||||||||||||||
172 | - | |||||||||||||||||||
173 | if (label)
| 0 | ||||||||||||||||||
174 | label->setGeometry(mlr, additionalSpacing, q->width() - mlr * 2, lh); never executed: label->setGeometry(mlr, additionalSpacing, q->width() - mlr * 2, lh); | 0 | ||||||||||||||||||
175 | bar->setGeometry(mlr, lh + sp + additionalSpacing, q->width() - mlr * 2, bh.height()); | - | ||||||||||||||||||
176 | } never executed: end of block | 0 | ||||||||||||||||||
177 | - | |||||||||||||||||||
178 | void QProgressDialogPrivate::retranslateStrings() | - | ||||||||||||||||||
179 | { | - | ||||||||||||||||||
180 | if (useDefaultCancelText)
| 0 | ||||||||||||||||||
181 | setCancelButtonText(QProgressDialog::tr("Cancel")); never executed: setCancelButtonText(QProgressDialog::tr("Cancel")); | 0 | ||||||||||||||||||
182 | } never executed: end of block | 0 | ||||||||||||||||||
183 | - | |||||||||||||||||||
184 | void QProgressDialogPrivate::_q_disconnectOnClose() | - | ||||||||||||||||||
185 | { | - | ||||||||||||||||||
186 | Q_Q(QProgressDialog); | - | ||||||||||||||||||
187 | if (receiverToDisconnectOnClose) {
| 0 | ||||||||||||||||||
188 | QObject::disconnect(q, SIGNAL(canceled()), receiverToDisconnectOnClose, | - | ||||||||||||||||||
189 | memberToDisconnectOnClose); | - | ||||||||||||||||||
190 | receiverToDisconnectOnClose = 0; | - | ||||||||||||||||||
191 | } never executed: end of block | 0 | ||||||||||||||||||
192 | memberToDisconnectOnClose.clear(); | - | ||||||||||||||||||
193 | } never executed: end of block | 0 | ||||||||||||||||||
194 | - | |||||||||||||||||||
195 | /*! | - | ||||||||||||||||||
196 | \class QProgressDialog | - | ||||||||||||||||||
197 | \brief The QProgressDialog class provides feedback on the progress of a slow operation. | - | ||||||||||||||||||
198 | \ingroup standard-dialogs | - | ||||||||||||||||||
199 | \inmodule QtWidgets | - | ||||||||||||||||||
200 | - | |||||||||||||||||||
201 | - | |||||||||||||||||||
202 | A progress dialog is used to give the user an indication of how long | - | ||||||||||||||||||
203 | an operation is going to take, and to demonstrate that the | - | ||||||||||||||||||
204 | application has not frozen. It can also give the user an opportunity | - | ||||||||||||||||||
205 | to abort the operation. | - | ||||||||||||||||||
206 | - | |||||||||||||||||||
207 | A common problem with progress dialogs is that it is difficult to know | - | ||||||||||||||||||
208 | when to use them; operations take different amounts of time on different | - | ||||||||||||||||||
209 | hardware. QProgressDialog offers a solution to this problem: | - | ||||||||||||||||||
210 | it estimates the time the operation will take (based on time for | - | ||||||||||||||||||
211 | steps), and only shows itself if that estimate is beyond minimumDuration() | - | ||||||||||||||||||
212 | (4 seconds by default). | - | ||||||||||||||||||
213 | - | |||||||||||||||||||
214 | Use setMinimum() and setMaximum() or the constructor to set the number of | - | ||||||||||||||||||
215 | "steps" in the operation and call setValue() as the operation | - | ||||||||||||||||||
216 | progresses. The number of steps can be chosen arbitrarily. It can be the | - | ||||||||||||||||||
217 | number of files copied, the number of bytes received, the number of | - | ||||||||||||||||||
218 | iterations through the main loop of your algorithm, or some other | - | ||||||||||||||||||
219 | suitable unit. Progress starts at the value set by setMinimum(), | - | ||||||||||||||||||
220 | and the progress dialog shows that the operation has finished when | - | ||||||||||||||||||
221 | you call setValue() with the value set by setMaximum() as its argument. | - | ||||||||||||||||||
222 | - | |||||||||||||||||||
223 | The dialog automatically resets and hides itself at the end of the | - | ||||||||||||||||||
224 | operation. Use setAutoReset() and setAutoClose() to change this | - | ||||||||||||||||||
225 | behavior. Note that if you set a new maximum (using setMaximum() or | - | ||||||||||||||||||
226 | setRange()) that equals your current value(), the dialog will not | - | ||||||||||||||||||
227 | close regardless. | - | ||||||||||||||||||
228 | - | |||||||||||||||||||
229 | There are two ways of using QProgressDialog: modal and modeless. | - | ||||||||||||||||||
230 | - | |||||||||||||||||||
231 | Compared to a modeless QProgressDialog, a modal QProgressDialog is simpler | - | ||||||||||||||||||
232 | to use for the programmer. Do the operation in a loop, call \l setValue() at | - | ||||||||||||||||||
233 | intervals, and check for cancellation with wasCanceled(). For example: | - | ||||||||||||||||||
234 | - | |||||||||||||||||||
235 | \snippet dialogs/dialogs.cpp 3 | - | ||||||||||||||||||
236 | - | |||||||||||||||||||
237 | A modeless progress dialog is suitable for operations that take | - | ||||||||||||||||||
238 | place in the background, where the user is able to interact with the | - | ||||||||||||||||||
239 | application. Such operations are typically based on QTimer (or | - | ||||||||||||||||||
240 | QObject::timerEvent()), QSocketNotifier, or QUrlOperator; or performed | - | ||||||||||||||||||
241 | in a separate thread. A QProgressBar in the status bar of your main window | - | ||||||||||||||||||
242 | is often an alternative to a modeless progress dialog. | - | ||||||||||||||||||
243 | - | |||||||||||||||||||
244 | You need to have an event loop to be running, connect the | - | ||||||||||||||||||
245 | canceled() signal to a slot that stops the operation, and call \l | - | ||||||||||||||||||
246 | setValue() at intervals. For example: | - | ||||||||||||||||||
247 | - | |||||||||||||||||||
248 | \snippet dialogs/dialogs.cpp 4 | - | ||||||||||||||||||
249 | \codeline | - | ||||||||||||||||||
250 | \snippet dialogs/dialogs.cpp 5 | - | ||||||||||||||||||
251 | \codeline | - | ||||||||||||||||||
252 | \snippet dialogs/dialogs.cpp 6 | - | ||||||||||||||||||
253 | - | |||||||||||||||||||
254 | In both modes the progress dialog may be customized by | - | ||||||||||||||||||
255 | replacing the child widgets with custom widgets by using setLabel(), | - | ||||||||||||||||||
256 | setBar(), and setCancelButton(). | - | ||||||||||||||||||
257 | The functions setLabelText() and setCancelButtonText() | - | ||||||||||||||||||
258 | set the texts shown. | - | ||||||||||||||||||
259 | - | |||||||||||||||||||
260 | \image fusion-progressdialog.png A progress dialog shown in the Fusion widget style. | - | ||||||||||||||||||
261 | - | |||||||||||||||||||
262 | \sa QDialog, QProgressBar, {fowler}{GUI Design Handbook: Progress Indicator}, | - | ||||||||||||||||||
263 | {Find Files Example}, {Pixelator Example} | - | ||||||||||||||||||
264 | */ | - | ||||||||||||||||||
265 | - | |||||||||||||||||||
266 | - | |||||||||||||||||||
267 | /*! | - | ||||||||||||||||||
268 | Constructs a progress dialog. | - | ||||||||||||||||||
269 | - | |||||||||||||||||||
270 | Default settings: | - | ||||||||||||||||||
271 | \list | - | ||||||||||||||||||
272 | \li The label text is empty. | - | ||||||||||||||||||
273 | \li The cancel button text is (translated) "Cancel". | - | ||||||||||||||||||
274 | \li minimum is 0; | - | ||||||||||||||||||
275 | \li maximum is 100 | - | ||||||||||||||||||
276 | \endlist | - | ||||||||||||||||||
277 | - | |||||||||||||||||||
278 | The \a parent argument is dialog's parent widget. The widget flags, \a f, are | - | ||||||||||||||||||
279 | passed to the QDialog::QDialog() constructor. | - | ||||||||||||||||||
280 | - | |||||||||||||||||||
281 | \sa setLabelText(), setCancelButtonText(), setCancelButton(), | - | ||||||||||||||||||
282 | setMinimum(), setMaximum() | - | ||||||||||||||||||
283 | */ | - | ||||||||||||||||||
284 | - | |||||||||||||||||||
285 | QProgressDialog::QProgressDialog(QWidget *parent, Qt::WindowFlags f) | - | ||||||||||||||||||
286 | : QDialog(*(new QProgressDialogPrivate), parent, f) | - | ||||||||||||||||||
287 | { | - | ||||||||||||||||||
288 | Q_D(QProgressDialog); | - | ||||||||||||||||||
289 | d->useDefaultCancelText = true; | - | ||||||||||||||||||
290 | d->init(QString::fromLatin1(""), QString(), 0, 100); | - | ||||||||||||||||||
291 | } never executed: end of block | 0 | ||||||||||||||||||
292 | - | |||||||||||||||||||
293 | /*! | - | ||||||||||||||||||
294 | Constructs a progress dialog. | - | ||||||||||||||||||
295 | - | |||||||||||||||||||
296 | The \a labelText is the text used to remind the user what is progressing. | - | ||||||||||||||||||
297 | - | |||||||||||||||||||
298 | The \a cancelButtonText is the text to display on the cancel button. If | - | ||||||||||||||||||
299 | QString() is passed then no cancel button is shown. | - | ||||||||||||||||||
300 | - | |||||||||||||||||||
301 | The \a minimum and \a maximum is the number of steps in the operation for | - | ||||||||||||||||||
302 | which this progress dialog shows progress. For example, if the | - | ||||||||||||||||||
303 | operation is to examine 50 files, this value minimum value would be 0, | - | ||||||||||||||||||
304 | and the maximum would be 50. Before examining the first file, call | - | ||||||||||||||||||
305 | setValue(0). As each file is processed call setValue(1), setValue(2), | - | ||||||||||||||||||
306 | etc., finally calling setValue(50) after examining the last file. | - | ||||||||||||||||||
307 | - | |||||||||||||||||||
308 | The \a parent argument is the dialog's parent widget. The parent, \a parent, and | - | ||||||||||||||||||
309 | widget flags, \a f, are passed to the QDialog::QDialog() constructor. | - | ||||||||||||||||||
310 | - | |||||||||||||||||||
311 | \sa setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), | - | ||||||||||||||||||
312 | setMinimum(), setMaximum() | - | ||||||||||||||||||
313 | */ | - | ||||||||||||||||||
314 | - | |||||||||||||||||||
315 | QProgressDialog::QProgressDialog(const QString &labelText, | - | ||||||||||||||||||
316 | const QString &cancelButtonText, | - | ||||||||||||||||||
317 | int minimum, int maximum, | - | ||||||||||||||||||
318 | QWidget *parent, Qt::WindowFlags f) | - | ||||||||||||||||||
319 | : QDialog(*(new QProgressDialogPrivate), parent, f) | - | ||||||||||||||||||
320 | { | - | ||||||||||||||||||
321 | Q_D(QProgressDialog); | - | ||||||||||||||||||
322 | d->init(labelText, cancelButtonText, minimum, maximum); | - | ||||||||||||||||||
323 | } never executed: end of block | 0 | ||||||||||||||||||
324 | - | |||||||||||||||||||
325 | - | |||||||||||||||||||
326 | /*! | - | ||||||||||||||||||
327 | Destroys the progress dialog. | - | ||||||||||||||||||
328 | */ | - | ||||||||||||||||||
329 | - | |||||||||||||||||||
330 | QProgressDialog::~QProgressDialog() | - | ||||||||||||||||||
331 | { | - | ||||||||||||||||||
332 | } | - | ||||||||||||||||||
333 | - | |||||||||||||||||||
334 | /*! | - | ||||||||||||||||||
335 | \fn void QProgressDialog::canceled() | - | ||||||||||||||||||
336 | - | |||||||||||||||||||
337 | This signal is emitted when the cancel button is clicked. | - | ||||||||||||||||||
338 | It is connected to the cancel() slot by default. | - | ||||||||||||||||||
339 | - | |||||||||||||||||||
340 | \sa wasCanceled() | - | ||||||||||||||||||
341 | */ | - | ||||||||||||||||||
342 | - | |||||||||||||||||||
343 | - | |||||||||||||||||||
344 | /*! | - | ||||||||||||||||||
345 | Sets the label to \a label. The progress dialog resizes to fit. The | - | ||||||||||||||||||
346 | label becomes owned by the progress dialog and will be deleted when | - | ||||||||||||||||||
347 | necessary, so do not pass the address of an object on the stack. | - | ||||||||||||||||||
348 | - | |||||||||||||||||||
349 | \sa setLabelText() | - | ||||||||||||||||||
350 | */ | - | ||||||||||||||||||
351 | - | |||||||||||||||||||
352 | void QProgressDialog::setLabel(QLabel *label) | - | ||||||||||||||||||
353 | { | - | ||||||||||||||||||
354 | Q_D(QProgressDialog); | - | ||||||||||||||||||
355 | if (label == d->label) {
| 0 | ||||||||||||||||||
356 | if (label)
| 0 | ||||||||||||||||||
357 | qWarning("QProgressDialog::setLabel: Attempt to set the same label again"); never executed: QMessageLogger(__FILE__, 357, __PRETTY_FUNCTION__).warning("QProgressDialog::setLabel: Attempt to set the same label again"); | 0 | ||||||||||||||||||
358 | return; never executed: return; | 0 | ||||||||||||||||||
359 | } | - | ||||||||||||||||||
360 | delete d->label; | - | ||||||||||||||||||
361 | d->label = label; | - | ||||||||||||||||||
362 | d->adoptChildWidget(label); | - | ||||||||||||||||||
363 | } never executed: end of block | 0 | ||||||||||||||||||
364 | - | |||||||||||||||||||
365 | - | |||||||||||||||||||
366 | /*! | - | ||||||||||||||||||
367 | \property QProgressDialog::labelText | - | ||||||||||||||||||
368 | \brief the label's text | - | ||||||||||||||||||
369 | - | |||||||||||||||||||
370 | The default text is an empty string. | - | ||||||||||||||||||
371 | */ | - | ||||||||||||||||||
372 | - | |||||||||||||||||||
373 | QString QProgressDialog::labelText() const | - | ||||||||||||||||||
374 | { | - | ||||||||||||||||||
375 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
376 | if (d->label)
| 0 | ||||||||||||||||||
377 | return d->label->text(); never executed: return d->label->text(); | 0 | ||||||||||||||||||
378 | return QString(); never executed: return QString(); | 0 | ||||||||||||||||||
379 | } | - | ||||||||||||||||||
380 | - | |||||||||||||||||||
381 | void QProgressDialog::setLabelText(const QString &text) | - | ||||||||||||||||||
382 | { | - | ||||||||||||||||||
383 | Q_D(QProgressDialog); | - | ||||||||||||||||||
384 | if (d->label) {
| 0 | ||||||||||||||||||
385 | d->label->setText(text); | - | ||||||||||||||||||
386 | d->ensureSizeIsAtLeastSizeHint(); | - | ||||||||||||||||||
387 | } never executed: end of block | 0 | ||||||||||||||||||
388 | } never executed: end of block | 0 | ||||||||||||||||||
389 | - | |||||||||||||||||||
390 | - | |||||||||||||||||||
391 | /*! | - | ||||||||||||||||||
392 | Sets the cancel button to the push button, \a cancelButton. The | - | ||||||||||||||||||
393 | progress dialog takes ownership of this button which will be deleted | - | ||||||||||||||||||
394 | when necessary, so do not pass the address of an object that is on | - | ||||||||||||||||||
395 | the stack, i.e. use new() to create the button. If 0 is passed then | - | ||||||||||||||||||
396 | no cancel button will be shown. | - | ||||||||||||||||||
397 | - | |||||||||||||||||||
398 | \sa setCancelButtonText() | - | ||||||||||||||||||
399 | */ | - | ||||||||||||||||||
400 | - | |||||||||||||||||||
401 | void QProgressDialog::setCancelButton(QPushButton *cancelButton) | - | ||||||||||||||||||
402 | { | - | ||||||||||||||||||
403 | Q_D(QProgressDialog); | - | ||||||||||||||||||
404 | if (d->cancel == cancelButton) {
| 0 | ||||||||||||||||||
405 | if (cancelButton)
| 0 | ||||||||||||||||||
406 | qWarning("QProgressDialog::setCancelButton: Attempt to set the same button again"); never executed: QMessageLogger(__FILE__, 406, __PRETTY_FUNCTION__).warning("QProgressDialog::setCancelButton: Attempt to set the same button again"); | 0 | ||||||||||||||||||
407 | return; never executed: return; | 0 | ||||||||||||||||||
408 | } | - | ||||||||||||||||||
409 | delete d->cancel; | - | ||||||||||||||||||
410 | d->cancel = cancelButton; | - | ||||||||||||||||||
411 | if (cancelButton) {
| 0 | ||||||||||||||||||
412 | connect(d->cancel, SIGNAL(clicked()), this, SIGNAL(canceled())); | - | ||||||||||||||||||
413 | #ifndef QT_NO_SHORTCUT | - | ||||||||||||||||||
414 | // FIXME: This only registers the primary key sequence of the cancel action | - | ||||||||||||||||||
415 | d->escapeShortcut = new QShortcut(QKeySequence::Cancel, this, SIGNAL(canceled())); | - | ||||||||||||||||||
416 | #endif | - | ||||||||||||||||||
417 | } else { never executed: end of block | 0 | ||||||||||||||||||
418 | #ifndef QT_NO_SHORTCUT | - | ||||||||||||||||||
419 | delete d->escapeShortcut; | - | ||||||||||||||||||
420 | d->escapeShortcut = 0; | - | ||||||||||||||||||
421 | #endif | - | ||||||||||||||||||
422 | } never executed: end of block | 0 | ||||||||||||||||||
423 | d->adoptChildWidget(cancelButton); | - | ||||||||||||||||||
424 | } never executed: end of block | 0 | ||||||||||||||||||
425 | - | |||||||||||||||||||
426 | /*! | - | ||||||||||||||||||
427 | Sets the cancel button's text to \a cancelButtonText. If the text | - | ||||||||||||||||||
428 | is set to QString() then it will cause the cancel button to be | - | ||||||||||||||||||
429 | hidden and deleted. | - | ||||||||||||||||||
430 | - | |||||||||||||||||||
431 | \sa setCancelButton() | - | ||||||||||||||||||
432 | */ | - | ||||||||||||||||||
433 | - | |||||||||||||||||||
434 | void QProgressDialog::setCancelButtonText(const QString &cancelButtonText) | - | ||||||||||||||||||
435 | { | - | ||||||||||||||||||
436 | Q_D(QProgressDialog); | - | ||||||||||||||||||
437 | d->useDefaultCancelText = false; | - | ||||||||||||||||||
438 | d->setCancelButtonText(cancelButtonText); | - | ||||||||||||||||||
439 | } never executed: end of block | 0 | ||||||||||||||||||
440 | - | |||||||||||||||||||
441 | void QProgressDialogPrivate::setCancelButtonText(const QString &cancelButtonText) | - | ||||||||||||||||||
442 | { | - | ||||||||||||||||||
443 | Q_Q(QProgressDialog); | - | ||||||||||||||||||
444 | - | |||||||||||||||||||
445 | if (!cancelButtonText.isNull()) {
| 0 | ||||||||||||||||||
446 | if (cancel) {
| 0 | ||||||||||||||||||
447 | cancel->setText(cancelButtonText); | - | ||||||||||||||||||
448 | } else { never executed: end of block | 0 | ||||||||||||||||||
449 | q->setCancelButton(new QPushButton(cancelButtonText, q)); | - | ||||||||||||||||||
450 | } never executed: end of block | 0 | ||||||||||||||||||
451 | } else { | - | ||||||||||||||||||
452 | q->setCancelButton(0); | - | ||||||||||||||||||
453 | } never executed: end of block | 0 | ||||||||||||||||||
454 | ensureSizeIsAtLeastSizeHint(); | - | ||||||||||||||||||
455 | } never executed: end of block | 0 | ||||||||||||||||||
456 | - | |||||||||||||||||||
457 | - | |||||||||||||||||||
458 | /*! | - | ||||||||||||||||||
459 | Sets the progress bar widget to \a bar. The progress dialog resizes to | - | ||||||||||||||||||
460 | fit. The progress dialog takes ownership of the progress \a bar which | - | ||||||||||||||||||
461 | will be deleted when necessary, so do not use a progress bar | - | ||||||||||||||||||
462 | allocated on the stack. | - | ||||||||||||||||||
463 | */ | - | ||||||||||||||||||
464 | - | |||||||||||||||||||
465 | void QProgressDialog::setBar(QProgressBar *bar) | - | ||||||||||||||||||
466 | { | - | ||||||||||||||||||
467 | Q_D(QProgressDialog); | - | ||||||||||||||||||
468 | if (!bar) {
| 0 | ||||||||||||||||||
469 | qWarning("QProgressDialog::setBar: Cannot set a null progress bar"); | - | ||||||||||||||||||
470 | return; never executed: return; | 0 | ||||||||||||||||||
471 | } | - | ||||||||||||||||||
472 | #ifndef QT_NO_DEBUG | - | ||||||||||||||||||
473 | if (value() > 0)
| 0 | ||||||||||||||||||
474 | qWarning("QProgressDialog::setBar: Cannot set a new progress bar " never executed: QMessageLogger(__FILE__, 474, __PRETTY_FUNCTION__).warning("QProgressDialog::setBar: Cannot set a new progress bar " "while the old one is active"); | 0 | ||||||||||||||||||
475 | "while the old one is active"); never executed: QMessageLogger(__FILE__, 474, __PRETTY_FUNCTION__).warning("QProgressDialog::setBar: Cannot set a new progress bar " "while the old one is active"); | 0 | ||||||||||||||||||
476 | #endif | - | ||||||||||||||||||
477 | if (bar == d->bar) {
| 0 | ||||||||||||||||||
478 | qWarning("QProgressDialog::setBar: Attempt to set the same progress bar again"); | - | ||||||||||||||||||
479 | return; never executed: return; | 0 | ||||||||||||||||||
480 | } | - | ||||||||||||||||||
481 | delete d->bar; | - | ||||||||||||||||||
482 | d->bar = bar; | - | ||||||||||||||||||
483 | d->adoptChildWidget(bar); | - | ||||||||||||||||||
484 | } never executed: end of block | 0 | ||||||||||||||||||
485 | - | |||||||||||||||||||
486 | void QProgressDialogPrivate::adoptChildWidget(QWidget *c) | - | ||||||||||||||||||
487 | { | - | ||||||||||||||||||
488 | Q_Q(QProgressDialog); | - | ||||||||||||||||||
489 | - | |||||||||||||||||||
490 | if (c) {
| 0 | ||||||||||||||||||
491 | if (c->parentWidget() == q)
| 0 | ||||||||||||||||||
492 | c->hide(); // until after ensureSizeIsAtLeastSizeHint() never executed: c->hide(); | 0 | ||||||||||||||||||
493 | else | - | ||||||||||||||||||
494 | c->setParent(q, 0); never executed: c->setParent(q, 0); | 0 | ||||||||||||||||||
495 | } | - | ||||||||||||||||||
496 | ensureSizeIsAtLeastSizeHint(); | - | ||||||||||||||||||
497 | if (c)
| 0 | ||||||||||||||||||
498 | c->show(); never executed: c->show(); | 0 | ||||||||||||||||||
499 | } never executed: end of block | 0 | ||||||||||||||||||
500 | - | |||||||||||||||||||
501 | void QProgressDialogPrivate::ensureSizeIsAtLeastSizeHint() | - | ||||||||||||||||||
502 | { | - | ||||||||||||||||||
503 | Q_Q(QProgressDialog); | - | ||||||||||||||||||
504 | - | |||||||||||||||||||
505 | QSize size = q->sizeHint(); | - | ||||||||||||||||||
506 | if (q->isVisible())
| 0 | ||||||||||||||||||
507 | size = size.expandedTo(q->size()); never executed: size = size.expandedTo(q->size()); | 0 | ||||||||||||||||||
508 | q->resize(size); | - | ||||||||||||||||||
509 | } never executed: end of block | 0 | ||||||||||||||||||
510 | - | |||||||||||||||||||
511 | - | |||||||||||||||||||
512 | /*! | - | ||||||||||||||||||
513 | \property QProgressDialog::wasCanceled | - | ||||||||||||||||||
514 | \brief whether the dialog was canceled | - | ||||||||||||||||||
515 | */ | - | ||||||||||||||||||
516 | - | |||||||||||||||||||
517 | bool QProgressDialog::wasCanceled() const | - | ||||||||||||||||||
518 | { | - | ||||||||||||||||||
519 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
520 | return d->cancellation_flag; never executed: return d->cancellation_flag; | 0 | ||||||||||||||||||
521 | } | - | ||||||||||||||||||
522 | - | |||||||||||||||||||
523 | - | |||||||||||||||||||
524 | /*! | - | ||||||||||||||||||
525 | \property QProgressDialog::maximum | - | ||||||||||||||||||
526 | \brief the highest value represented by the progress bar | - | ||||||||||||||||||
527 | - | |||||||||||||||||||
528 | The default is 100. | - | ||||||||||||||||||
529 | - | |||||||||||||||||||
530 | \sa minimum, setRange() | - | ||||||||||||||||||
531 | */ | - | ||||||||||||||||||
532 | - | |||||||||||||||||||
533 | int QProgressDialog::maximum() const | - | ||||||||||||||||||
534 | { | - | ||||||||||||||||||
535 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
536 | return d->bar->maximum(); never executed: return d->bar->maximum(); | 0 | ||||||||||||||||||
537 | } | - | ||||||||||||||||||
538 | - | |||||||||||||||||||
539 | void QProgressDialog::setMaximum(int maximum) | - | ||||||||||||||||||
540 | { | - | ||||||||||||||||||
541 | Q_D(QProgressDialog); | - | ||||||||||||||||||
542 | d->bar->setMaximum(maximum); | - | ||||||||||||||||||
543 | } never executed: end of block | 0 | ||||||||||||||||||
544 | - | |||||||||||||||||||
545 | /*! | - | ||||||||||||||||||
546 | \property QProgressDialog::minimum | - | ||||||||||||||||||
547 | \brief the lowest value represented by the progress bar | - | ||||||||||||||||||
548 | - | |||||||||||||||||||
549 | The default is 0. | - | ||||||||||||||||||
550 | - | |||||||||||||||||||
551 | \sa maximum, setRange() | - | ||||||||||||||||||
552 | */ | - | ||||||||||||||||||
553 | - | |||||||||||||||||||
554 | int QProgressDialog::minimum() const | - | ||||||||||||||||||
555 | { | - | ||||||||||||||||||
556 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
557 | return d->bar->minimum(); never executed: return d->bar->minimum(); | 0 | ||||||||||||||||||
558 | } | - | ||||||||||||||||||
559 | - | |||||||||||||||||||
560 | void QProgressDialog::setMinimum(int minimum) | - | ||||||||||||||||||
561 | { | - | ||||||||||||||||||
562 | Q_D(QProgressDialog); | - | ||||||||||||||||||
563 | d->bar->setMinimum(minimum); | - | ||||||||||||||||||
564 | } never executed: end of block | 0 | ||||||||||||||||||
565 | - | |||||||||||||||||||
566 | /*! | - | ||||||||||||||||||
567 | Sets the progress dialog's minimum and maximum values | - | ||||||||||||||||||
568 | to \a minimum and \a maximum, respectively. | - | ||||||||||||||||||
569 | - | |||||||||||||||||||
570 | If \a maximum is smaller than \a minimum, \a minimum becomes the only | - | ||||||||||||||||||
571 | legal value. | - | ||||||||||||||||||
572 | - | |||||||||||||||||||
573 | If the current value falls outside the new range, the progress | - | ||||||||||||||||||
574 | dialog is reset with reset(). | - | ||||||||||||||||||
575 | - | |||||||||||||||||||
576 | \sa minimum, maximum | - | ||||||||||||||||||
577 | */ | - | ||||||||||||||||||
578 | void QProgressDialog::setRange(int minimum, int maximum) | - | ||||||||||||||||||
579 | { | - | ||||||||||||||||||
580 | Q_D(QProgressDialog); | - | ||||||||||||||||||
581 | d->bar->setRange(minimum, maximum); | - | ||||||||||||||||||
582 | } never executed: end of block | 0 | ||||||||||||||||||
583 | - | |||||||||||||||||||
584 | - | |||||||||||||||||||
585 | /*! | - | ||||||||||||||||||
586 | Resets the progress dialog. | - | ||||||||||||||||||
587 | The progress dialog becomes hidden if autoClose() is true. | - | ||||||||||||||||||
588 | - | |||||||||||||||||||
589 | \sa setAutoClose(), setAutoReset() | - | ||||||||||||||||||
590 | */ | - | ||||||||||||||||||
591 | - | |||||||||||||||||||
592 | void QProgressDialog::reset() | - | ||||||||||||||||||
593 | { | - | ||||||||||||||||||
594 | Q_D(QProgressDialog); | - | ||||||||||||||||||
595 | #ifndef QT_NO_CURSOR | - | ||||||||||||||||||
596 | if (value() >= 0) {
| 0 | ||||||||||||||||||
597 | if (parentWidget())
| 0 | ||||||||||||||||||
598 | parentWidget()->setCursor(d->parentCursor); never executed: parentWidget()->setCursor(d->parentCursor); | 0 | ||||||||||||||||||
599 | } never executed: end of block | 0 | ||||||||||||||||||
600 | #endif | - | ||||||||||||||||||
601 | if (d->autoClose || d->forceHide)
| 0 | ||||||||||||||||||
602 | hide(); never executed: hide(); | 0 | ||||||||||||||||||
603 | d->bar->reset(); | - | ||||||||||||||||||
604 | d->cancellation_flag = false; | - | ||||||||||||||||||
605 | d->shown_once = false; | - | ||||||||||||||||||
606 | d->setValue_called = false; | - | ||||||||||||||||||
607 | d->forceTimer->stop(); | - | ||||||||||||||||||
608 | - | |||||||||||||||||||
609 | /* | - | ||||||||||||||||||
610 | I wish we could disconnect the user slot provided to open() here but | - | ||||||||||||||||||
611 | unfortunately reset() is usually called before the slot has been invoked. | - | ||||||||||||||||||
612 | (reset() is itself invoked when canceled() is emitted.) | - | ||||||||||||||||||
613 | */ | - | ||||||||||||||||||
614 | if (d->receiverToDisconnectOnClose)
| 0 | ||||||||||||||||||
615 | QMetaObject::invokeMethod(this, "_q_disconnectOnClose", Qt::QueuedConnection); never executed: QMetaObject::invokeMethod(this, "_q_disconnectOnClose", Qt::QueuedConnection); | 0 | ||||||||||||||||||
616 | } never executed: end of block | 0 | ||||||||||||||||||
617 | - | |||||||||||||||||||
618 | /*! | - | ||||||||||||||||||
619 | Resets the progress dialog. wasCanceled() becomes true until | - | ||||||||||||||||||
620 | the progress dialog is reset. | - | ||||||||||||||||||
621 | The progress dialog becomes hidden. | - | ||||||||||||||||||
622 | */ | - | ||||||||||||||||||
623 | - | |||||||||||||||||||
624 | void QProgressDialog::cancel() | - | ||||||||||||||||||
625 | { | - | ||||||||||||||||||
626 | Q_D(QProgressDialog); | - | ||||||||||||||||||
627 | d->forceHide = true; | - | ||||||||||||||||||
628 | reset(); | - | ||||||||||||||||||
629 | d->forceHide = false; | - | ||||||||||||||||||
630 | d->cancellation_flag = true; | - | ||||||||||||||||||
631 | } never executed: end of block | 0 | ||||||||||||||||||
632 | - | |||||||||||||||||||
633 | - | |||||||||||||||||||
634 | int QProgressDialog::value() const | - | ||||||||||||||||||
635 | { | - | ||||||||||||||||||
636 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
637 | return d->bar->value(); never executed: return d->bar->value(); | 0 | ||||||||||||||||||
638 | } | - | ||||||||||||||||||
639 | - | |||||||||||||||||||
640 | /*! | - | ||||||||||||||||||
641 | \property QProgressDialog::value | - | ||||||||||||||||||
642 | \brief the current amount of progress made. | - | ||||||||||||||||||
643 | - | |||||||||||||||||||
644 | For the progress dialog to work as expected, you should initially set | - | ||||||||||||||||||
645 | this property to QProgressDialog::minimum() and finally set it to | - | ||||||||||||||||||
646 | QProgressDialog::maximum(); you can call setValue() any number of times | - | ||||||||||||||||||
647 | in-between. | - | ||||||||||||||||||
648 | - | |||||||||||||||||||
649 | \warning If the progress dialog is modal | - | ||||||||||||||||||
650 | (see QProgressDialog::QProgressDialog()), | - | ||||||||||||||||||
651 | setValue() calls QApplication::processEvents(), so take care that | - | ||||||||||||||||||
652 | this does not cause undesirable re-entrancy in your code. For example, | - | ||||||||||||||||||
653 | don't use a QProgressDialog inside a paintEvent()! | - | ||||||||||||||||||
654 | - | |||||||||||||||||||
655 | \sa minimum, maximum | - | ||||||||||||||||||
656 | */ | - | ||||||||||||||||||
657 | void QProgressDialog::setValue(int progress) | - | ||||||||||||||||||
658 | { | - | ||||||||||||||||||
659 | Q_D(QProgressDialog); | - | ||||||||||||||||||
660 | if (d->setValue_called && progress == d->bar->value())
| 0 | ||||||||||||||||||
661 | return; never executed: return; | 0 | ||||||||||||||||||
662 | - | |||||||||||||||||||
663 | d->bar->setValue(progress); | - | ||||||||||||||||||
664 | - | |||||||||||||||||||
665 | if (d->shown_once) {
| 0 | ||||||||||||||||||
666 | if (isModal())
| 0 | ||||||||||||||||||
667 | QApplication::processEvents(); never executed: QApplication::processEvents(); | 0 | ||||||||||||||||||
668 | } else { never executed: end of block | 0 | ||||||||||||||||||
669 | if ((!d->setValue_called && progress == 0 /* for compat with Qt < 5.4 */) || progress == minimum()) {
| 0 | ||||||||||||||||||
670 | d->starttime.start(); | - | ||||||||||||||||||
671 | d->forceTimer->start(d->showTime); | - | ||||||||||||||||||
672 | d->setValue_called = true; | - | ||||||||||||||||||
673 | return; never executed: return; | 0 | ||||||||||||||||||
674 | } else { | - | ||||||||||||||||||
675 | d->setValue_called = true; | - | ||||||||||||||||||
676 | bool need_show; | - | ||||||||||||||||||
677 | int elapsed = d->starttime.elapsed(); | - | ||||||||||||||||||
678 | if (elapsed >= d->showTime) {
| 0 | ||||||||||||||||||
679 | need_show = true; | - | ||||||||||||||||||
680 | } else { never executed: end of block | 0 | ||||||||||||||||||
681 | if (elapsed > minWaitTime) {
| 0 | ||||||||||||||||||
682 | int estimate; | - | ||||||||||||||||||
683 | int totalSteps = maximum() - minimum(); | - | ||||||||||||||||||
684 | int myprogress = progress - minimum(); | - | ||||||||||||||||||
685 | if (myprogress == 0) myprogress = 1; never executed: myprogress = 1;
| 0 | ||||||||||||||||||
686 | if ((totalSteps - myprogress) >= INT_MAX / elapsed)
| 0 | ||||||||||||||||||
687 | estimate = (totalSteps - myprogress) / myprogress * elapsed; never executed: estimate = (totalSteps - myprogress) / myprogress * elapsed; | 0 | ||||||||||||||||||
688 | else | - | ||||||||||||||||||
689 | estimate = elapsed * (totalSteps - myprogress) / myprogress; never executed: estimate = elapsed * (totalSteps - myprogress) / myprogress; | 0 | ||||||||||||||||||
690 | need_show = estimate >= d->showTime; | - | ||||||||||||||||||
691 | } else { never executed: end of block | 0 | ||||||||||||||||||
692 | need_show = false; | - | ||||||||||||||||||
693 | } never executed: end of block | 0 | ||||||||||||||||||
694 | } | - | ||||||||||||||||||
695 | if (need_show) {
| 0 | ||||||||||||||||||
696 | d->ensureSizeIsAtLeastSizeHint(); | - | ||||||||||||||||||
697 | show(); | - | ||||||||||||||||||
698 | d->shown_once = true; | - | ||||||||||||||||||
699 | } never executed: end of block | 0 | ||||||||||||||||||
700 | } never executed: end of block | 0 | ||||||||||||||||||
701 | } | - | ||||||||||||||||||
702 | - | |||||||||||||||||||
703 | if (progress == d->bar->maximum() && d->autoReset)
| 0 | ||||||||||||||||||
704 | reset(); never executed: reset(); | 0 | ||||||||||||||||||
705 | } never executed: end of block | 0 | ||||||||||||||||||
706 | - | |||||||||||||||||||
707 | /*! | - | ||||||||||||||||||
708 | Returns a size that fits the contents of the progress dialog. | - | ||||||||||||||||||
709 | The progress dialog resizes itself as required, so you should not | - | ||||||||||||||||||
710 | need to call this yourself. | - | ||||||||||||||||||
711 | */ | - | ||||||||||||||||||
712 | - | |||||||||||||||||||
713 | QSize QProgressDialog::sizeHint() const | - | ||||||||||||||||||
714 | { | - | ||||||||||||||||||
715 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
716 | QSize sh = d->label ? d->label->sizeHint() : QSize(0, 0);
| 0 | ||||||||||||||||||
717 | QSize bh = d->bar->sizeHint(); | - | ||||||||||||||||||
718 | int margin = style()->pixelMetric(QStyle::PM_DefaultTopLevelMargin); | - | ||||||||||||||||||
719 | int spacing = style()->pixelMetric(QStyle::PM_DefaultLayoutSpacing); | - | ||||||||||||||||||
720 | int h = margin * 2 + bh.height() + sh.height() + spacing; | - | ||||||||||||||||||
721 | if (d->cancel)
| 0 | ||||||||||||||||||
722 | h += d->cancel->sizeHint().height() + spacing; never executed: h += d->cancel->sizeHint().height() + spacing; | 0 | ||||||||||||||||||
723 | return QSize(qMax(200, sh.width() + 2 * margin), h); never executed: return QSize(qMax(200, sh.width() + 2 * margin), h); | 0 | ||||||||||||||||||
724 | } | - | ||||||||||||||||||
725 | - | |||||||||||||||||||
726 | /*!\reimp | - | ||||||||||||||||||
727 | */ | - | ||||||||||||||||||
728 | void QProgressDialog::resizeEvent(QResizeEvent *) | - | ||||||||||||||||||
729 | { | - | ||||||||||||||||||
730 | Q_D(QProgressDialog); | - | ||||||||||||||||||
731 | d->layout(); | - | ||||||||||||||||||
732 | } never executed: end of block | 0 | ||||||||||||||||||
733 | - | |||||||||||||||||||
734 | /*! | - | ||||||||||||||||||
735 | \reimp | - | ||||||||||||||||||
736 | */ | - | ||||||||||||||||||
737 | void QProgressDialog::changeEvent(QEvent *ev) | - | ||||||||||||||||||
738 | { | - | ||||||||||||||||||
739 | Q_D(QProgressDialog); | - | ||||||||||||||||||
740 | if (ev->type() == QEvent::StyleChange) {
| 0 | ||||||||||||||||||
741 | d->layout(); | - | ||||||||||||||||||
742 | } else if (ev->type() == QEvent::LanguageChange) { never executed: end of block
| 0 | ||||||||||||||||||
743 | d->retranslateStrings(); | - | ||||||||||||||||||
744 | } never executed: end of block | 0 | ||||||||||||||||||
745 | QDialog::changeEvent(ev); | - | ||||||||||||||||||
746 | } never executed: end of block | 0 | ||||||||||||||||||
747 | - | |||||||||||||||||||
748 | /*! | - | ||||||||||||||||||
749 | \property QProgressDialog::minimumDuration | - | ||||||||||||||||||
750 | \brief the time that must pass before the dialog appears | - | ||||||||||||||||||
751 | - | |||||||||||||||||||
752 | If the expected duration of the task is less than the | - | ||||||||||||||||||
753 | minimumDuration, the dialog will not appear at all. This prevents | - | ||||||||||||||||||
754 | the dialog popping up for tasks that are quickly over. For tasks | - | ||||||||||||||||||
755 | that are expected to exceed the minimumDuration, the dialog will | - | ||||||||||||||||||
756 | pop up after the minimumDuration time or as soon as any progress | - | ||||||||||||||||||
757 | is set. | - | ||||||||||||||||||
758 | - | |||||||||||||||||||
759 | If set to 0, the dialog is always shown as soon as any progress is | - | ||||||||||||||||||
760 | set. The default is 4000 milliseconds. | - | ||||||||||||||||||
761 | */ | - | ||||||||||||||||||
762 | void QProgressDialog::setMinimumDuration(int ms) | - | ||||||||||||||||||
763 | { | - | ||||||||||||||||||
764 | Q_D(QProgressDialog); | - | ||||||||||||||||||
765 | d->showTime = ms; | - | ||||||||||||||||||
766 | if (d->bar->value() == d->bar->minimum()) {
| 0 | ||||||||||||||||||
767 | d->forceTimer->stop(); | - | ||||||||||||||||||
768 | d->forceTimer->start(ms); | - | ||||||||||||||||||
769 | } never executed: end of block | 0 | ||||||||||||||||||
770 | } never executed: end of block | 0 | ||||||||||||||||||
771 | - | |||||||||||||||||||
772 | int QProgressDialog::minimumDuration() const | - | ||||||||||||||||||
773 | { | - | ||||||||||||||||||
774 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
775 | return d->showTime; never executed: return d->showTime; | 0 | ||||||||||||||||||
776 | } | - | ||||||||||||||||||
777 | - | |||||||||||||||||||
778 | - | |||||||||||||||||||
779 | /*! | - | ||||||||||||||||||
780 | \reimp | - | ||||||||||||||||||
781 | */ | - | ||||||||||||||||||
782 | - | |||||||||||||||||||
783 | void QProgressDialog::closeEvent(QCloseEvent *e) | - | ||||||||||||||||||
784 | { | - | ||||||||||||||||||
785 | emit canceled(); | - | ||||||||||||||||||
786 | QDialog::closeEvent(e); | - | ||||||||||||||||||
787 | } never executed: end of block | 0 | ||||||||||||||||||
788 | - | |||||||||||||||||||
789 | /*! | - | ||||||||||||||||||
790 | \property QProgressDialog::autoReset | - | ||||||||||||||||||
791 | \brief whether the progress dialog calls reset() as soon as value() equals maximum() | - | ||||||||||||||||||
792 | - | |||||||||||||||||||
793 | The default is true. | - | ||||||||||||||||||
794 | - | |||||||||||||||||||
795 | \sa setAutoClose() | - | ||||||||||||||||||
796 | */ | - | ||||||||||||||||||
797 | - | |||||||||||||||||||
798 | void QProgressDialog::setAutoReset(bool b) | - | ||||||||||||||||||
799 | { | - | ||||||||||||||||||
800 | Q_D(QProgressDialog); | - | ||||||||||||||||||
801 | d->autoReset = b; | - | ||||||||||||||||||
802 | } never executed: end of block | 0 | ||||||||||||||||||
803 | - | |||||||||||||||||||
804 | bool QProgressDialog::autoReset() const | - | ||||||||||||||||||
805 | { | - | ||||||||||||||||||
806 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
807 | return d->autoReset; never executed: return d->autoReset; | 0 | ||||||||||||||||||
808 | } | - | ||||||||||||||||||
809 | - | |||||||||||||||||||
810 | /*! | - | ||||||||||||||||||
811 | \property QProgressDialog::autoClose | - | ||||||||||||||||||
812 | \brief whether the dialog gets hidden by reset() | - | ||||||||||||||||||
813 | - | |||||||||||||||||||
814 | The default is true. | - | ||||||||||||||||||
815 | - | |||||||||||||||||||
816 | \sa setAutoReset() | - | ||||||||||||||||||
817 | */ | - | ||||||||||||||||||
818 | - | |||||||||||||||||||
819 | void QProgressDialog::setAutoClose(bool close) | - | ||||||||||||||||||
820 | { | - | ||||||||||||||||||
821 | Q_D(QProgressDialog); | - | ||||||||||||||||||
822 | d->autoClose = close; | - | ||||||||||||||||||
823 | } never executed: end of block | 0 | ||||||||||||||||||
824 | - | |||||||||||||||||||
825 | bool QProgressDialog::autoClose() const | - | ||||||||||||||||||
826 | { | - | ||||||||||||||||||
827 | Q_D(const QProgressDialog); | - | ||||||||||||||||||
828 | return d->autoClose; never executed: return d->autoClose; | 0 | ||||||||||||||||||
829 | } | - | ||||||||||||||||||
830 | - | |||||||||||||||||||
831 | /*! | - | ||||||||||||||||||
832 | \reimp | - | ||||||||||||||||||
833 | */ | - | ||||||||||||||||||
834 | - | |||||||||||||||||||
835 | void QProgressDialog::showEvent(QShowEvent *e) | - | ||||||||||||||||||
836 | { | - | ||||||||||||||||||
837 | Q_D(QProgressDialog); | - | ||||||||||||||||||
838 | QDialog::showEvent(e); | - | ||||||||||||||||||
839 | d->ensureSizeIsAtLeastSizeHint(); | - | ||||||||||||||||||
840 | d->forceTimer->stop(); | - | ||||||||||||||||||
841 | } never executed: end of block | 0 | ||||||||||||||||||
842 | - | |||||||||||||||||||
843 | /*! | - | ||||||||||||||||||
844 | Shows the dialog if it is still hidden after the algorithm has been started | - | ||||||||||||||||||
845 | and minimumDuration milliseconds have passed. | - | ||||||||||||||||||
846 | - | |||||||||||||||||||
847 | \sa setMinimumDuration() | - | ||||||||||||||||||
848 | */ | - | ||||||||||||||||||
849 | - | |||||||||||||||||||
850 | void QProgressDialog::forceShow() | - | ||||||||||||||||||
851 | { | - | ||||||||||||||||||
852 | Q_D(QProgressDialog); | - | ||||||||||||||||||
853 | d->forceTimer->stop(); | - | ||||||||||||||||||
854 | if (d->shown_once || d->cancellation_flag)
| 0 | ||||||||||||||||||
855 | return; never executed: return; | 0 | ||||||||||||||||||
856 | - | |||||||||||||||||||
857 | show(); | - | ||||||||||||||||||
858 | d->shown_once = true; | - | ||||||||||||||||||
859 | } never executed: end of block | 0 | ||||||||||||||||||
860 | - | |||||||||||||||||||
861 | /*! | - | ||||||||||||||||||
862 | \since 4.5 | - | ||||||||||||||||||
863 | \overload | - | ||||||||||||||||||
864 | - | |||||||||||||||||||
865 | Opens the dialog and connects its canceled() signal to the slot specified | - | ||||||||||||||||||
866 | by \a receiver and \a member. | - | ||||||||||||||||||
867 | - | |||||||||||||||||||
868 | The signal will be disconnected from the slot when the dialog is closed. | - | ||||||||||||||||||
869 | */ | - | ||||||||||||||||||
870 | void QProgressDialog::open(QObject *receiver, const char *member) | - | ||||||||||||||||||
871 | { | - | ||||||||||||||||||
872 | Q_D(QProgressDialog); | - | ||||||||||||||||||
873 | connect(this, SIGNAL(canceled()), receiver, member); | - | ||||||||||||||||||
874 | d->receiverToDisconnectOnClose = receiver; | - | ||||||||||||||||||
875 | d->memberToDisconnectOnClose = member; | - | ||||||||||||||||||
876 | QDialog::open(); | - | ||||||||||||||||||
877 | } never executed: end of block | 0 | ||||||||||||||||||
878 | - | |||||||||||||||||||
879 | QT_END_NAMESPACE | - | ||||||||||||||||||
880 | - | |||||||||||||||||||
881 | #include "moc_qprogressdialog.cpp" | - | ||||||||||||||||||
882 | - | |||||||||||||||||||
883 | #endif // QT_NO_PROGRESSDIALOG | - | ||||||||||||||||||
Source code | Switch to Preprocessed file |