Q3ProgressDialog Class Reference

 #include <Q3ProgressDialog>

 Q3ProgressDialog progress("Copying files...", "Abort Copy", numFiles,
                           this, "progress", true);
 for (int i = 0; i < numFiles; i++) {
     progress.setProgress(i);
     qApp->processEvents();

     if (progress.wasCanceled())
         break;
     //... copy one file
 }
 progress.setProgress(numFiles);

 Operation::Operation(QObject *parent = 0)
     : QObject(parent), steps(0)
 {
     pd = new Q3ProgressDialog("Operation in progress.", "Cancel", 100);
     connect(pd, SIGNAL(canceled()), this, SLOT(cancel()));
     t = new QTimer(this);
     connect(t, SIGNAL(timeout()), this, SLOT(perform()));
     t->start(0);
 }

 void Operation::perform()
 {
     pd->setProgress(steps);
     //... perform one percent of the operation
     steps++;
     if (steps > pd->totalSteps())
         t->stop();
 }

 void Operation::cancel()
 {
     t->stop();
     //... cleanup
 }

Member Function Documentation

Q3ProgressDialog::Q3ProgressDialog ( QWidget * creator, const char * name, bool modal = false, Qt::WindowFlags f = 0 )

Constructs a progress dialog.

Default settings:

• The label text is empty.
• The cancel button text is (translated) "Cancel".
• The total number of steps is 100.

The creator argument is the widget to use as the dialog's parent. The name, modal, and the widget flags, f, are passed to the QDialog::QDialog() constructor. If modal is false (the default), you must have an event loop proceeding for any redrawing of the dialog to occur. If modal is true, the dialog ensures that events are processed when needed.

See also setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), and setTotalSteps().

Q3ProgressDialog::Q3ProgressDialog ( const QString & labelText, const QString & cancelButtonText, int totalSteps, QWidget * creator = 0, const char * name = 0, bool modal = false, Qt::WindowFlags f = 0 )

Constructs a progress dialog.

The labelText is text used to remind the user what is progressing.

The cancelButtonText is the text to display on the cancel button, or 0 if no cancel button is to be shown.

The totalSteps is the total number of steps in the operation for which this progress dialog shows progress. For example, if the operation is to examine 50 files, this value would be 50. Before examining the first file, call setProgress(0). As each file is processed call setProgress(1), setProgress(2), etc., finally calling setProgress(50) after examining the last file.

The creator argument is the widget to use as the dialog's parent. The name, modal, and widget flags, f, are passed to the QDialog::QDialog() constructor. If modal is false (the default), you will must have an event loop proceeding for any redrawing of the dialog to occur. If modal is true, the dialog ensures that events are processed when needed.

See also setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), and setTotalSteps().

Q3ProgressDialog::Q3ProgressDialog ( QWidget * creator = 0, Qt::WindowFlags f = 0 )

Constructs a progress dialog.

Default settings:

• The label text is empty.
• The cancel button text is (translated) "Cancel".
• The total number of steps is 100.

The creator argument is the widget to use as the dialog's parent. The widget flags, f, are passed to the QDialog::QDialog() constructor.

See also setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), and setTotalSteps().

Q3ProgressDialog::Q3ProgressDialog ( const QString & labelText, const QString & cancelButtonText, int totalSteps, QWidget * creator = 0, Qt::WindowFlags f = 0 )

Constructs a progress dialog.

The labelText is text used to remind the user what is progressing.

The cancelButtonText is the text to display on the cancel button, or 0 if no cancel button is to be shown.

The totalSteps is the total number of steps in the operation for which this progress dialog shows progress. For example, if the operation is to examine 50 files, this value would be 50. Before examining the first file, call setProgress(0). As each file is processed call setProgress(1), setProgress(2), etc., finally calling setProgress(50) after examining the last file.

The creator argument is the widget to use as the dialog's parent. The widget flags, f, are passed to the QDialog::QDialog() constructor.

See also setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), and setTotalSteps().

Q3ProgressDialog::~Q3ProgressDialog ()

Destroys the progress dialog.

void Q3ProgressDialog::cancel () [slot]

Resets the progress dialog. wasCanceled() becomes true until the progress dialog is reset. The progress dialog becomes hidden.

void Q3ProgressDialog::canceled () [signal]

This signal is emitted when the cancel button is clicked. It is connected to the cancel() slot by default.

See also wasCanceled().

void Q3ProgressDialog::cancelled () [signal]

Use canceled() instead.

void Q3ProgressDialog::changeEvent ( QEvent * ev ) [virtual protected]

Reimplemented from QWidget::changeEvent().

void Q3ProgressDialog::closeEvent ( QCloseEvent * e ) [virtual protected]

Reimplemented from QWidget::closeEvent().

void Q3ProgressDialog::forceShow () [protected slot]

Shows the dialog if it is still hidden after the algorithm has been started and minimumDuration milliseconds have passed.

See also setMinimumDuration().

void Q3ProgressDialog::reset () [slot]

Resets the progress dialog. The progress dialog becomes hidden if autoClose() is true.

See also setAutoClose() and setAutoReset().

void Q3ProgressDialog::resizeEvent ( QResizeEvent * ) [virtual protected]

Reimplemented from QWidget::resizeEvent().

void Q3ProgressDialog::setBar ( Q3ProgressBar * bar )

Sets the progress bar widget to bar. The progress dialog resizes to fit. The progress dialog takes ownership of the progress bar which will be deleted when necessary, so do not use a progress bar allocated on the stack.

void Q3ProgressDialog::setCancelButton ( QPushButton * cancelButton )

Sets the cancel button to the push button, cancelButton. The progress dialog takes ownership of this button which will be deleted when necessary, so do not pass the address of an object that is on the stack, i.e. use new() to create the button.

See also setCancelButtonText().

void Q3ProgressDialog::setCancelButtonText ( const QString & cancelButtonText ) [slot]

Sets the cancel button's text to cancelButtonText.

See also setCancelButton().

void Q3ProgressDialog::setLabel ( QLabel * label )

Sets the label to label. The progress dialog resizes to fit. The label becomes owned by the progress dialog and will be deleted when necessary, so do not pass the address of an object on the stack.

See also setLabelText().

void Q3ProgressDialog::showEvent ( QShowEvent * e ) [virtual protected]

Reimplemented from QWidget::showEvent().

QSize Q3ProgressDialog::sizeHint () const [virtual]

Reimplemented from QWidget::sizeHint().

Returns a size that fits the contents of the progress dialog. The progress dialog resizes itself as required, so you should not need to call this yourself.