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

返回一个能容纳进度对话框内容的大小。进度对话框会根据需要自动调整大小，因此您通常无需手动调用此函数。