QProgressDialog Class

QProgressDialog progress("Copying files...", "Abort Copy", 0, numFiles, this);
progress.setWindowModality(Qt::WindowModal);

for (int i = 0; i < numFiles; i++) {
    progress.setValue(i);

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

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

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

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

Documentación de funciones miembro

[explicit] QProgressDialog::QProgressDialog(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Construye un diálogo de progreso.

Configuración por defecto:

• El texto de la etiqueta está vacío.
• El texto del botón de cancelación es (traducido) "Cancelar".
• El mínimo es 0;
• máximo es 100

El argumento parent es el widget padre del diálogo. Las banderas del widget, f, se pasan al constructor QDialog::QDialog().

Véase también setLabelText(), setCancelButtonText(), setCancelButton(), setMinimum(), y setMaximum().

QProgressDialog::QProgressDialog(const QString &labelText, const QString &cancelButtonText, int minimum, int maximum, QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Construye un diálogo de progreso.

El labelText es el texto utilizado para recordar al usuario lo que está progresando.

El cancelButtonText es el texto a mostrar en el botón de cancelar. Si se pasa QString() no se muestra ningún botón de cancelación.

minimum y maximum es el número de pasos de la operación para los que este diálogo de progreso muestra el progreso. Por ejemplo, si la operación es examinar 50 ficheros, este valor mínimo sería 0, y el máximo sería 50. Antes de examinar el primer fichero, llame a setValue(0). A medida que se procesa cada fichero se llama a setValue(1), setValue(2), etc., llamando finalmente a setValue(50) después de examinar el último fichero.

El argumento parent es el widget padre del diálogo. El padre, parent, y las banderas del widget, f, se pasan al constructor QDialog::QDialog().

Véase también setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), setMinimum(), y setMaximum().

[virtual noexcept] QProgressDialog::~QProgressDialog()

Destruye el diálogo de progreso.

[slot] void QProgressDialog::cancel()

Reinicia el diálogo de progreso. wasCanceled() se convierte en verdadero hasta que se reinicia el diálogo de progreso. El diálogo de progreso se oculta.

[signal] void QProgressDialog::canceled()

Esta señal se emite cuando se pulsa el botón de cancelación. Está conectada por defecto a la ranura cancel().

Véase también wasCanceled().

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

Reimplementa: QWidget::changeEvent(QEvent *event).

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

Reimplementa: QDialog::closeEvent(QCloseEvent *e).

[protected slot] void QProgressDialog::forceShow()

Muestra el diálogo si sigue oculto después de que se haya iniciado el algoritmo y hayan transcurrido minimumDuration milisegundos.

Véase también setMinimumDuration().

void QProgressDialog::open(QObject *receiver, const char *member)

Abre el diálogo y conecta su señal canceled() a la ranura especificada por receiver y member.

La señal se desconectará de la ranura cuando se cierre el diálogo.

[slot] void QProgressDialog::reset()

Restablece el diálogo de progreso. El diálogo de progreso se oculta si autoClose() es verdadero.

Véase también setAutoClose() y setAutoReset().

[override virtual protected] void QProgressDialog::resizeEvent(QResizeEvent *event)

Reimplementa: QDialog::resizeEvent(QResizeEvent *).

void QProgressDialog::setBar(QProgressBar *bar)

Establece el widget de la barra de progreso en bar. El diálogo de progreso se redimensiona para ajustarse. El diálogo de progreso se apropia del progreso bar que se borrará cuando sea necesario, así que no utilices una barra de progreso asignada en la pila.

void QProgressDialog::setCancelButton(QPushButton *cancelButton)

Establece el botón de cancelación en el botón pulsador, cancelButton. El diálogo de progreso toma posesión de este botón que será borrado cuando sea necesario, así que no pases la dirección de un objeto que esté en la pila, es decir, usa new() para crear el botón. Si se pasa nullptr, no se mostrará ningún botón de cancelación.

Véase también setCancelButtonText().

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

Establece el texto del botón de cancelación a cancelButtonText. Si el texto es establecido a QString() entonces causará que el botón de cancelación sea ocultado y borrado.

Véase también setCancelButton().

void QProgressDialog::setLabel(QLabel *label)

Establece la etiqueta en label. El diálogo de progreso se redimensiona para ajustarse. La etiqueta pasa a ser propiedad del diálogo de progreso y se borrará cuando sea necesario, así que no pases la dirección de un objeto en la pila.

Véase también setLabelText().

[slot] void QProgressDialog::setRange(int minimum, int maximum)

Establece los valores mínimo y máximo del diálogo de progreso en minimum y maximum, respectivamente.

Si maximum es menor que minimum, minimum se convierte en el único valor legal.

Si el valor actual queda fuera del nuevo rango, el diálogo de progreso se reinicia con reset().

Véase también minimum y maximum.

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

Reimplementa: QDialog::showEvent(QShowEvent *event).

[override virtual] QSize QProgressDialog::sizeHint() const

Reimplementa: QDialog::sizeHint() const.

Devuelve un tamaño que se ajusta al contenido del diálogo de progreso. El diálogo de progreso se redimensiona a sí mismo según sea necesario, por lo que no debería ser necesario llamar a esta función.