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
}

メンバ関数ドキュメント

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

進捗ダイアログを作成します。

デフォルト設定：

• ラベルテキストは空です。
• キャンセルボタンのテキストは（翻訳済み）"Cancel "です。
• 最小値は0；
• 最大値は100

parent 引数はダイアログの親ウィジェットです。ウィジェットのフラグ、f は、QDialog::QDialog() コンストラクタに渡されます。

setLabelText()、setCancelButtonText()、setCancelButton()、setMinimum()、setMaximum()も参照 。

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

進行ダイアログを作成する。

labelText は、進行状況をユーザーに知らせるためのテキストです。

cancelButtonText は、キャンセル・ボタンに表示するテキストです。QString() が渡された場合は、キャンセル・ボタンは表示されません。

minimum およびmaximum は、この進行状況ダイアログが進行状況を表示する操作のステップ数です。例えば、50個のファイルを検査する操作の場合、この値の最小値は0、最大値は50になります。最初のファイルを検査する前に、setValue （0）を呼び出す。各ファイルが処理されるごとに、setValue(1)、setValue(2)などを呼び出し、最後に最後のファイルを検査した後、setValue(50)を呼び出す。

引数parent は、ダイアログの親ウィジェットである。親ウィジェットparent とウィジェット・フラグf は、QDialog::QDialog() コンストラクタに渡される。

setLabelText()、setLabel()、setCancelButtonText()、setCancelButton()、setMinimum()、setMaximum()も参照のこと 。

[virtual noexcept] QProgressDialog::~QProgressDialog()

進捗ダイアログを破棄する。

[slot] void QProgressDialog::cancel()

進行ダイアログをリセットする。wasCanceled() は進行ダイアログがリセットされるまで真になります。進行ダイアログは非表示になります。

[signal] void QProgressDialog::canceled()

このシグナルは、キャンセル・ボタンがクリックされたときに発せられる。デフォルトではcancel() スロットに接続されている。

wasCanceled()も参照 。

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

再実装：QWidget::changeEvent(QEvent *event)。

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

再インプリメント：QDialog::closeEvent(QCloseEvent *e)。

[protected slot] void QProgressDialog::forceShow()

アルゴリズムが開始され、minimumDuration ミリ秒経過してもダイアログが非表示の場合、ダイアログを表示する。

setMinimumDuration()も参照 。

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

ダイアログを開き、そのcanceled() シグナルをreceiver とmember で指定されたスロットに接続する。

ダイアログが閉じられると、シグナルはスロットから切り離されます。

[slot] void QProgressDialog::reset()

進行ダイアログをリセットする。autoClose() が true の場合、プログレス・ダイアログは非表示になる。

setAutoClose() およびsetAutoReset()も参照 。

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

再実装：QDialog::resizeEvent(QResizeEvent *).

void QProgressDialog::setBar(QProgressBar *bar)

プログレス・バー・ウィジェットをbar に設定する。 プログレス・ダイアログは、そのサイズに合うようにリサイズされる。プログレスダイアログは、必要に応じて削除されるプログレスバーbar のオーナーシップを取りますので、スタックに割り当てられたプログレスバーを使用しないでください。

void QProgressDialog::setCancelButton(QPushButton *cancelButton)

キャンセルボタンをプッシュボタンcancelButton に設定します。プログレス・ダイアログがこのボタンの所有権を持ち、必要なときに削除されるので、スタック上にあるオブジェクトのアドレスを渡さないでください。nullptr を渡すと、キャンセルボタンは表示されません。

setCancelButtonText()も参照 。

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

キャンセル・ボタンのテキストをcancelButtonText に設定します。 テキストが QString() に設定されると、キャンセル・ボタンが非表示になり、削除されます。

setCancelButton()も参照してください 。

void QProgressDialog::setLabel(QLabel *label)

ラベルをlabel に設定します。 プログレスダイアログのサイズが変更されます。ラベルはプログレスダイアログが所有し、必要なときに削除されるので、スタック上のオブジェクトのアドレスを渡さないでください。

setLabelText()も参照してください 。

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

進行ダイアログの最小値と最大値をそれぞれminimum とmaximum に設定する。

maximum がminimum より小さい場合、minimum が唯一の有効な値となる。

現在の値が新しい範囲から外れる場合、プログレス・ダイアログはreset() でリセットされます。

minimum およびmaximumも参照のこと 。

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

再実装：QDialog::showEvent(QShowEvent *event)。

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

再実装：QDialog::sizeHint() const.

プログレスダイアログの内容に合うサイズを返します。プログレスダイアログは必要に応じて自分自身のサイズを変更するので、自分でこれを呼び出す必要はありません。