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
}

Documentation sur les fonctions membres

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

Affiche une boîte de dialogue de progression.

Paramètres par défaut :

• Le texte de l'étiquette est vide.
• Le texte du bouton « Annuler » est « Annuler » (traduit).
• La valeur minimale est 0 ;
• maximum est 100

L'argument ` parent ` correspond au widget parent de la boîte de dialogue. Les indicateurs du widget, ` f`, sont transmis au constructeur ` QDialog::QDialog()`.

Voir également setLabelText(), setCancelButtonText(), setCancelButton(), setMinimum() et setMaximum().

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

Affiche une boîte de dialogue de progression.

labelText correspond au texte utilisé pour indiquer à l'utilisateur l'état d'avancement de l'opération.

cancelButtonText est le texte à afficher sur le bouton d’annulation. Si QString() est passé, aucun bouton d’annulation n’est affiché.

Les paramètres « minimum » et « maximum » correspondent respectivement au nombre de pas de l’opération pour laquelle cette boîte de dialogue de progression affiche la progression. Par exemple, si l’opération consiste à analyser 50 fichiers, la valeur minimale de ce paramètre serait 0 et la valeur maximale 50. Avant d’analyser le premier fichier, appelez setValue(0). Au fur et à mesure que chaque fichier est traité, appelez setValue(0), setValue(2), etc., puis appelez enfin setValue(50) après avoir examiné le dernier fichier.

L'argument parent correspond au widget parent de la boîte de dialogue. Le parent, parent, et les indicateurs de widget, f, sont transmis au constructeur QDialog::QDialog().

Voir également setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), setMinimum() et setMaximum().

[virtual noexcept] QProgressDialog::~QProgressDialog()

Ferme la boîte de dialogue de progression.

[slot] void QProgressDialog::cancel()

Réinitialise la boîte de dialogue de progression. La méthode ` wasCanceled()` renvoie `true` jusqu’à ce que la boîte de dialogue de progression soit réinitialisée. La boîte de dialogue de progression est masquée.

[signal] void QProgressDialog::canceled()

Ce signal est émis lorsque l'on clique sur le bouton « Annuler ». Il est associé par défaut au slot cancel().

Voir également wasCanceled().

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

Réimplémente : QWidget::changeEvent(QEvent *event).

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

Réimplémente : QDialog::closeEvent(QCloseEvent *e).

[protected slot] void QProgressDialog::forceShow()

Affiche la boîte de dialogue si celle-ci est toujours masquée après le lancement de l'algorithme et au bout de minimumDuration millisecondes.

Voir également setMinimumDuration().

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

Ouvre la boîte de dialogue et relie son signal « canceled() » au slot spécifié par « receiver » et « member ».

Le signal sera déconnecté du slot lorsque la boîte de dialogue sera fermée.

[slot] void QProgressDialog::reset()

Réinitialise la boîte de dialogue de progression. Celle-ci est masquée si la valeur de autoClose() est « true ».

Voir également setAutoClose() et setAutoReset().

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

Réimplémente : QDialog::resizeEvent(QResizeEvent *).

void QProgressDialog::setBar(QProgressBar *bar)

Définit le widget de la barre de progression sur « bar ». La boîte de dialogue de progression s'adapte automatiquement à la taille de l'écran. La boîte de dialogue de progression prend en charge l'bar de la barre de progression, qui sera supprimée le moment venu ; il ne faut donc pas utiliser une barre de progression allouée sur la pile.

void QProgressDialog::setCancelButton(QPushButton *cancelButton)

Attribue le bouton « Annuler » au bouton cancelButton. La boîte de dialogue de progression prend en charge ce bouton, qui sera supprimé le moment venu ; veillez donc à ne pas passer l'adresse d'un objet situé sur la pile, c'est-à-dire à utiliser la fonction new() pour créer le bouton. Si l'on passe la valeur « nullptr », aucun bouton « Annuler » ne s'affichera.

Voir également setCancelButtonText().

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

Définit le texte du bouton « Annuler » sur « cancelButtonText ». Si le texte est défini sur QString(), le bouton « Annuler » sera masqué et supprimé.

Voir aussi setCancelButton().

void QProgressDialog::setLabel(QLabel *label)

Définit le libellé sur « label ». La boîte de dialogue de progression s'adapte automatiquement à la taille du texte. Le libellé devient la propriété de la boîte de dialogue de progression et sera supprimé si nécessaire ; veillez donc à ne pas transmettre l'adresse d'un objet situé sur la pile.

Voir aussi setLabelText().

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

Définit les valeurs minimale et maximale de la boîte de dialogue de progression respectivement sur minimum et maximum.

Si maximum est inférieur à minimum, minimum devient la seule valeur valide.

Si la valeur actuelle se situe en dehors de la nouvelle plage, la boîte de dialogue de progression est réinitialisée avec reset().

Voir également minimum et maximum.

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

Réimplémente : QDialog::showEvent(QShowEvent *event).

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

Réimplémente : QDialog::sizeHint() const.

Renvoie une taille adaptée au contenu de la boîte de dialogue de progression. La boîte de dialogue de progression s'ajuste automatiquement selon les besoins ; vous ne devriez donc pas avoir besoin d'appeler cette fonction vous-même.