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 des fonctions membres

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

Construit une boîte de dialogue de progression.

Paramètres par défaut :

• Le texte de l'étiquette est vide.
• Le texte du bouton d'annulation est "Annuler".
• Le minimum est de 0 ;
• le maximum est 100

L'argument parent est le widget parent du dialogue. Les drapeaux du widget, f, sont transmis au constructeur QDialog::QDialog().

Voir aussi 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())

Construit une boîte de dialogue de progression.

Le labelText est le texte utilisé pour rappeler à l'utilisateur ce qui est en train de se passer.

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

Les valeurs minimum et maximum correspondent au nombre d'étapes de l'opération pour lesquelles la boîte de dialogue de progression indique l'état d'avancement. Par exemple, si l'opération consiste à examiner 50 fichiers, la valeur minimale sera 0 et la valeur maximale sera 50. Avant d'examiner le premier fichier, appelez setValue(0). Au fur et à mesure que chaque fichier est traité, appelez setValue(1), setValue(2), etc., et appelez finalement setValue(50) après avoir examiné le dernier fichier.

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

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

[virtual noexcept] QProgressDialog::~QProgressDialog()

Détruit la boîte de dialogue de progression.

[slot] void QProgressDialog::cancel()

Réinitialise la boîte de dialogue de progression. wasCanceled() devient vrai jusqu'à ce que la boîte de dialogue de progression soit réinitialisée. La boîte de dialogue de progression devient cachée.

[signal] void QProgressDialog::canceled()

Ce signal est émis lorsque le bouton d'annulation est cliqué. Il est connecté par défaut à l'emplacement cancel().

Voir aussi 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 elle est toujours cachée après que l'algorithme a été lancé et que minimumDuration millisecondes se sont écoulées.

Voir également setMinimumDuration().

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

Ouvre la boîte de dialogue et connecte son signal canceled() à l'emplacement spécifié par receiver et member.

Le signal sera déconnecté de l'emplacement lorsque la boîte de dialogue sera fermée.

[slot] void QProgressDialog::reset()

Réinitialise la boîte de dialogue de progression. La boîte de dialogue de progression devient cachée si autoClose() est vrai.

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 à bar. La boîte de dialogue de progression se redimensionne pour s'adapter. La boîte de dialogue de progression est propriétaire de la barre de progression bar qui sera supprimée le cas échéant, il ne faut donc pas utiliser une barre de progression allouée sur la pile.

void QProgressDialog::setCancelButton(QPushButton *cancelButton)

Définit le bouton d'annulation comme étant le bouton poussoir, cancelButton. La boîte de dialogue de progression est propriétaire de ce bouton qui sera supprimé si nécessaire. Ne passez donc pas l'adresse d'un objet qui se trouve sur la pile, c'est-à-dire utilisez new() pour créer le bouton. Si nullptr est passé, aucun bouton d'annulation ne sera affiché.

Voir aussi setCancelButtonText().

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

Définit le texte du bouton d'annulation à cancelButtonText. Si le texte est défini à QString(), le bouton d'annulation sera caché et supprimé.

Voir également setCancelButton().

void QProgressDialog::setLabel(QLabel *label)

Fixe l'étiquette à label. Le dialogue de progression se redimensionne pour s'y adapter. L'étiquette devient la propriété de la boîte de dialogue de progression et sera supprimée si nécessaire. Ne passez donc pas l'adresse d'un objet sur la pile.

Voir aussi setLabelText().

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

Fixe les valeurs minimale et maximale de la boîte de dialogue de progression à minimum et maximum, respectivement.

Si maximum est plus petit que minimum, minimum devient la seule valeur légale.

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 correspondant au contenu de la boîte de dialogue de progression. La boîte de dialogue de progression se redimensionne elle-même si nécessaire, vous ne devriez donc pas avoir besoin d'appeler cette fonction vous-même.