QProgressDialog 类

    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
}

成员函数说明

[显式] 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() const。

返回一个适合进度对话框内容的大小。进度对话框需要时将自动调整大小，因此您通常不需要调用此方法。