一、常用基本API：

    1. // 构造函数
    2. /*
    3. 参数:
    4.   - labelText: 对话框中显示的提示信息
    5.   - cancelButtonText: 取消按钮上显示的文本信息
    6.   - minimum: 进度条最小值
    7.   - maximum: 进度条最大值
    8.   - parent: 当前窗口的父对象
    9.   - f: 当前进度窗口的flag属性, 使用默认属性即可, 无需设置
    10. */
    11. QProgressDialog::QProgressDialog(
    12.     QWidget *parent = nullptr, 
    13.     Qt::WindowFlags f = Qt::WindowFlags());
    15. QProgressDialog::QProgressDialog(
    16.     const QString &labelText, const QString &cancelButtonText, 
    17.     int minimum, int maximum, QWidget *parent = nullptr,
    18.     Qt::WindowFlags f = Qt::WindowFlags());
    21. // 设置取消按钮显示的文本信息
    22. [slot] void QProgressDialog::setCancelButtonText(const QString &cancelButtonText);
    24. // 公共成员函数和槽函数
    25. QString QProgressDialog::labelText() const;
    26. void QProgressDialog::setLabelText(const QString &text);
    28. // 得到进度条最小值
    29. int QProgressDialog::minimum() const;
    30. // 设置进度条最小值
    31. void QProgressDialog::setMinimum(int minimum);
    33. // 得到进度条最大值
    34. int QProgressDialog::maximum() const;
    35. // 设置进度条最大值
    36. void QProgressDialog::setMaximum(int maximum);
    38. // 设置进度条范围(最大和最小值)
    39. [slot] void QProgressDialog::setRange(int minimum, int maximum);
    41. // 得到进度条当前的值
    42. int QProgressDialog::value() const;
    43. // 设置进度条当前的值
    44. void QProgressDialog::setValue(int progress);
    47. bool QProgressDialog::autoReset() const;
    48. // 当value() = maximum()时，进程对话框是否调用reset()，此属性默认为true。
    49. void QProgressDialog::setAutoReset(bool reset);
    52. bool QProgressDialog::autoClose() const;
    53. // 当value() = maximum()时，进程对话框是否调用reset()并且隐藏，此属性默认为true。
    54. void QProgressDialog::setAutoClose(bool close);
    56. // 判断用户是否按下了取消键, 按下了返回true, 否则返回false
    57. bool wasCanceled() const;
    60. // 重置进度条
    61. // 重置进度对话框。wascancelled()变为true，直到进程对话框被重置。进度对话框被隐藏。
    62. [slot] void QProgressDialog::cancel();
    63. // 重置进度对话框。如果autoClose()为真，进程对话框将隐藏。
    64. [slot] void QProgressDialog::reset();   
    66. // 信号
    67. // 当单击cancel按钮时，将发出此信号。默认情况下，它连接到cancel()槽。
    68. [signal] void QProgressDialog::canceled();
    70. // 设置窗口的显示状态(模态, 非模态)
    71. /*
    72. 参数:
    73.     Qt::NonModal  -> 非模态
    74.     Qt::WindowModal    -> 模态, 阻塞父窗口
    75.     Qt::ApplicationModal -> 模态, 阻塞应用程序中的所有窗口
    76. */
    77. void QWidget::setWindowModality(Qt::WindowModality windowModality);