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

進行状況ダイアログを作成します。

デフォルト設定：

• ラベルのテキストは空です。
• 「キャンセル」ボタンのテキストは（翻訳済み）「キャンセル」です。
• 最小値は 0、
• maximumは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(0)、setValue(2) などを呼び出し、最後のファイルの検査終了後にsetValue(50) を呼び出します。

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

setLabelText()、setLabel()、setCancelButtonText()、setCancelButton()、setMinimum()、およびsetMaximum()も参照してください 。

[virtual noexcept] QProgressDialog::~QProgressDialog()

進行状況ダイアログを閉じます。

[slot] void QProgressDialog::cancel()

進行状況ダイアログをリセットします。進行状況ダイアログがリセットされるまで、wasCanceled() の値は true になります。進行状況ダイアログは非表示になります。

[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 」に設定します。進行状況ダイアログがこのボタンの所有権を取得し、必要に応じて削除するため、スタック上にあるオブジェクトのアドレスを渡さないでください。つまり、new() を使用してボタンを作成してください。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 を再実装します。

プログレスダイアログの内容に収まるサイズを返します。プログレスダイアログは必要に応じて自動的にサイズ変更を行うため、この関数を自ら呼び出す必要はありません。