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；
• 最大値は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

再リンプルメント: (QShowEvent *event)：QDialog::sizeHint() const.

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