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() 变为 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() 常量。

返回适合进度对话框内容的大小。进度对话框会根据需要自行调整大小，因此您无需自行调用。