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
}

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen Fortschrittsdialog.

Standardeinstellungen:

• Der Beschriftungstext ist leer.
• Der Text der Abbrechen-Schaltfläche ist (übersetzt) "Abbrechen".
• Minimum ist 0;
• Maximum ist 100

Das Argument parent ist das übergeordnete Widget des Dialogs. Die Widget-Flags, f, werden an den QDialog::QDialog() Konstruktor übergeben.

Siehe auch setLabelText(), setCancelButtonText(), setCancelButton(), setMinimum(), und setMaximum().

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

Konstruiert einen Fortschrittsdialog.

labelText ist der Text, der verwendet wird, um den Benutzer daran zu erinnern, was gerade passiert.

cancelButtonText ist der Text, der auf der Abbrechen-Schaltfläche angezeigt wird. Wenn QString() übergeben wird, wird keine Abbruchschaltfläche angezeigt.

minimum und maximum sind die Anzahl der Schritte des Vorgangs, für die dieser Fortschrittsdialog den Fortschritt anzeigt. Wenn der Vorgang beispielsweise 50 Dateien untersuchen soll, wäre der Mindestwert 0 und der Höchstwert 50. Bevor Sie die erste Datei untersuchen, rufen Sie setValue(0) auf. Während jede Datei verarbeitet wird, rufen Sie setValue(1), setValue(2) usw. auf und rufen schließlich setValue(50) auf, nachdem Sie die letzte Datei untersucht haben.

Das Argument parent ist das übergeordnete Widget des Dialogs. Das Elternteil, parent, und die Widget-Flags, f, werden an den Konstruktor QDialog::QDialog() übergeben.

Siehe auch setLabelText(), setLabel(), setCancelButtonText(), setCancelButton(), setMinimum(), und setMaximum().

[virtual noexcept] QProgressDialog::~QProgressDialog()

Zerstört den Fortschrittsdialog.

[slot] void QProgressDialog::cancel()

Setzt den Fortschrittsdialog zurück. wasCanceled() wird wahr, bis der Fortschrittsdialog zurückgesetzt wird. Der Fortschrittsdialog wird ausgeblendet.

[signal] void QProgressDialog::canceled()

Dieses Signal wird ausgegeben, wenn die Schaltfläche "Abbrechen" angeklickt wird. Es ist standardmäßig mit dem Slot cancel() verbunden.

Siehe auch wasCanceled().

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

Reimplements: QWidget::changeEvent(QEvent *Event).

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

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

[protected slot] void QProgressDialog::forceShow()

Zeigt das Dialogfeld an, wenn es nach dem Start des Algorithmus und nach Ablauf von minimumDuration Millisekunden noch ausgeblendet ist.

Siehe auch setMinimumDuration().

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

Öffnet das Dialogfeld und verbindet sein Signal canceled() mit dem durch receiver und member angegebenen Steckplatz.

Das Signal wird vom Slot getrennt, wenn das Dialogfeld geschlossen wird.

[slot] void QProgressDialog::reset()

Setzt den Fortschrittsdialog zurück. Der Fortschrittsdialog wird ausgeblendet, wenn autoClose() wahr ist.

Siehe auch setAutoClose() und setAutoReset().

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

Reimplements: QDialog::resizeEvent(QResizeEvent *).

void QProgressDialog::setBar(QProgressBar *bar)

Setzt das Fortschrittsbalken-Widget auf bar. Der Fortschrittsdialog passt seine Größe an. Der Fortschrittsdialog übernimmt das Eigentum am Fortschrittsbalken bar, der bei Bedarf gelöscht wird. Verwenden Sie also keinen Fortschrittsbalken, der auf dem Stapel liegt.

void QProgressDialog::setCancelButton(QPushButton *cancelButton)

Setzt die Abbruchtaste auf die Drucktaste, cancelButton. Der Fortschrittsdialog ist Eigentümer dieser Schaltfläche, die bei Bedarf gelöscht wird. Übergeben Sie also nicht die Adresse eines Objekts, das sich auf dem Stack befindet, d.h. verwenden Sie new(), um die Schaltfläche zu erstellen. Wenn nullptr übergeben wird, wird keine Abbrechen-Schaltfläche angezeigt.

Siehe auch setCancelButtonText().

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

Setzt den Text der Abbrechen-Schaltfläche auf cancelButtonText. Wenn der Text auf QString() gesetzt ist, wird die Abbrechen-Schaltfläche ausgeblendet und gelöscht.

Siehe auch setCancelButton().

void QProgressDialog::setLabel(QLabel *label)

Setzt das Label auf label. Die Größe des Fortschrittsdialogs wird entsprechend angepasst. Das Label wird Eigentum des Fortschrittsdialogs und wird bei Bedarf gelöscht, also übergeben Sie nicht die Adresse eines Objekts auf dem Stack.

Siehe auch setLabelText().

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

Setzt den Mindest- und Höchstwert des Fortschrittsdialogs auf minimum bzw. maximum.

Wenn maximum kleiner als minimum ist, wird minimum zum einzig zulässigen Wert.

Wenn der aktuelle Wert außerhalb des neuen Bereichs liegt, wird der Fortschrittsdialog mit reset() zurückgesetzt.

Siehe auch minimum und maximum.

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

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

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

Reimplements: QDialog::sizeHint() const.

Gibt eine Größe zurück, die dem Inhalt des Fortschrittsdialogs entspricht. Der Fortschrittsdialog ändert seine Größe bei Bedarf selbst, so dass Sie dies nicht selbst aufrufen müssen.