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 zu den Member-Funktionen

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

Erstellt einen Fortschrittsdialog.

Standardeinstellungen:

• Der Text der Beschriftung ist leer.
• Der Text der Schaltfläche „Abbrechen“ lautet (übersetzt) „Abbrechen“.
• Der Mindestwert ist 0;
• „maximum“ ist 100

Das Argument „ parent “ ist das übergeordnete Widget des Dialogs. Die Widget-Flags „ f “ werden an den Konstruktor „ QDialog::QDialog()“ ü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())

Erstellt einen Fortschrittsdialog.

„ labelText “ ist der Text, der den Benutzer darüber informiert, was gerade ausgeführt wird.

„ cancelButtonText “ ist der Text, der auf der Schaltfläche „Abbrechen“ angezeigt wird. Wird „QString()“ übergeben, wird keine Schaltfläche „Abbrechen“ angezeigt.

„ minimum “ und „ maximum “ geben die Anzahl der Schritte des Vorgangs an, für den dieser Fortschrittsdialog den Fortschritt anzeigt. Wenn der Vorgang beispielsweise die Überprüfung von 50 Dateien umfasst, wäre der Mindestwert 0 und der Höchstwert 50. Rufen Sie vor der Überprüfung der ersten Datei „ setValue(0)“ auf. Rufen Sie bei der Verarbeitung jeder Datei „ setValue “ (1), „ setValue “ (2) usw. auf und rufen Sie schließlich nach der Prüfung der letzten Datei „ setValue “ (50) auf.

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

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

[virtual noexcept] QProgressDialog::~QProgressDialog()

Schließt den Fortschrittsdialog.

[slot] void QProgressDialog::cancel()

Setzt den Fortschrittsdialog zurück. ` wasCanceled()` gibt „true“ zurück, bis der Fortschrittsdialog zurückgesetzt wird. Der Fortschrittsdialog wird ausgeblendet.

[signal] void QProgressDialog::canceled()

Dieses Signal wird ausgelöst, wenn auf die Schaltfläche „Abbrechen“ geklickt wird. Es ist standardmäßig mit dem Slot „ cancel()“ verbunden.

Siehe auch „ wasCanceled()“.

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

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

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

Umsetzt: ` 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 dessen Signal „ canceled()“ mit dem durch „ receiver “ und „ member “ angegebenen Slot.

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

[slot] void QProgressDialog::reset()

Setzt den Fortschrittsdialog zurück. Der Fortschrittsdialog wird ausgeblendet, wenn autoClose() den Wert „true“ hat.

Siehe auch setAutoClose() und setAutoReset().

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

Implementiert: ` QDialog::resizeEvent` (`QResizeEvent *`).

void QProgressDialog::setBar(QProgressBar *bar)

Setzt das Fortschrittsbalken-Widget auf „ bar “. Der Fortschrittsdialog passt seine Größe entsprechend an. Der Fortschrittsdialog übernimmt die Verantwortung für den Fortschritts bar, der bei Bedarf gelöscht wird. Verwenden Sie daher keinen auf dem Stack zugewiesenen Fortschrittsbalken.

void QProgressDialog::setCancelButton(QPushButton *cancelButton)

Weist dem Drucktaster die Schaltfläche „Abbrechen“ zu: cancelButton. Der Fortschrittsdialog übernimmt die Kontrolle über diese Schaltfläche, die bei Bedarf gelöscht wird. Übergeben Sie daher nicht die Adresse eines Objekts, das sich auf dem Stack befindet, d. h., verwenden Sie new(), um die Schaltfläche zu erstellen. Wird nullptr übergeben, wird keine Schaltfläche „Abbrechen“ angezeigt.

Siehe auch setCancelButtonText().

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

Setzt den Text der Schaltfläche „Abbrechen“ auf „ cancelButtonText “. Wird der Text auf „QString()“ gesetzt, wird die Schaltfläche „Abbrechen“ ausgeblendet und gelöscht.

Siehe auch ` setCancelButton()`.

void QProgressDialog::setLabel(QLabel *label)

Setzt die Beschriftung auf „ label “. Der Fortschrittsdialog passt seine Größe entsprechend an. Die Beschriftung wird vom Fortschrittsdialog verwaltet und bei Bedarf gelöscht. Übergeben Sie daher keine Adresse eines Objekts auf dem Stack.

Siehe auch ` setLabelText()`.

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

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

Ist maximum kleiner als minimum, ist minimum der einzig zulässige Wert.

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

Siehe auch ` minimum ` und ` maximum`.

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

Implementiert: ` QDialog::showEvent` (`QShowEvent *event`).

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

Implementiert neu: ` QDialog::sizeHint()` const.

Gibt eine Größe zurück, die zum Inhalt des Fortschrittsdialogs passt. Der Fortschrittsdialog passt seine Größe bei Bedarf selbst an, sodass Sie diese Funktion nicht selbst aufrufen müssen.