QProgressDialog Class Reference

[QtGui module]

该QProgressDialog类提供了一个缓慢的操作进度的反馈。More…

继承QDialog。

Methods

  • __init__ (self, QWidget parent = None, Qt.WindowFlags flags = 0)
  • __init__ (self, QString labelText, QString cancelButtonText, int minimum, int maximum, QWidget parent = None, Qt.WindowFlags flags = 0)
  • bool autoClose (self)
  • bool autoReset (self)
  • cancel (self)
  • changeEvent (self, QEvent)
  • closeEvent (self, QCloseEvent)
  • forceShow (self)
  • QString labelText (self)
  • int maximum (self)
  • int minimum (self)
  • int minimumDuration (self)
  • open (self)
  • open (self, QObject receiver, SLOT()SLOT() member)
  • open (self, callable receiver)
  • reset (self)
  • resizeEvent (self, QResizeEvent)
  • setAutoClose (self, bool b)
  • setAutoReset (self, bool b)
  • setBar (self, QProgressBar bar)
  • setCancelButton (self, QPushButton button)
  • setCancelButtonText (self, QString)
  • setLabel (self, QLabel label)
  • setLabelText (self, QString)
  • setMaximum (self, int maximum)
  • setMinimum (self, int minimum)
  • setMinimumDuration (self, int ms)
  • setRange (self, int minimum, int maximum)
  • setValue (self, int progress)
  • showEvent (self, QShowEvent e)
  • QSize sizeHint (self)
  • int value (self)
  • bool wasCanceled (self)

Qt Signals

  • void canceled ()

Detailed Description

该QProgressDialog类提供了一个缓慢的操作进度的反馈。

使用进度对话框，让用户多长时间的操作是要采取一个指示，并证明该应用程序并没有被冻结。它也可以让用户有机会中止操作。

一个常见的问题与进度对话框是，它是很难知道什么时候使用它们;操作需要不同的时间在不同的硬件。 QProgressDialog提供了一个解决这个问题：它估计当时的操作将（基于时间的步骤） ，并只显示本身，如果这一估计是超越minimumDuration（ ） （4秒默认情况下） 。

使用setMinimum（）和setMaximum（ ）或构造函数来设置的“台阶”的数量在操作和调用setValue（）作为操作进行。步数可以任意选择。它可以被复制的文件的个数，接收到的字节数，通过您的算法的主循环中，或一些其它合适的单元的迭代次数。进展开始于所设定的值setMinimum（ ） ，和进度对话框显示，当你调用操作已完成setValue（ ）与设定的值setMaximum（ ）作为它的参数。

该对话框会自动复位，并在手术结束隐藏自身。使用setAutoReset（）和setAutoClose（）来更改此行为。请注意，如果您设置了新的最大值（使用setMaximum（）或setRange（ ） ） ，等于您当前value（ ） ，该对话框不会关闭不管。

有使用QProgressDialog的方式有两种：模式和无模式。

相对于无模式QProgressDialog ，模态QProgressDialog更容易使用的程序员。做的操作在一个循环中，调用setValue（ ）间隔，并检查与取消wasCanceled（ ） 。例如：

  1.      QProgressDialog progress("Copying files...", "Abort Copy", 0, numFiles, this);
  2.      progress.setWindowModality([Qt](qt.html).WindowModal);
  4.      for (int i = 0; i < numFiles; i++) {
  5.          progress.setValue(i);
  7.          if (progress.wasCanceled())
  8.              break;
  9.          //... copy one file
  10.      }
  11.      progress.setValue(numFiles);

无模式进度对话框是适用于那些发生在后台，用户能够与应用程序交互操作。这种操作通常是基于QTimer（或QObject.timerEvent（）），QSocketNotifier或QUrlOperator;或在单独的线程执行。一QProgressBar在主窗口的状态栏往往是一种替代一个无模式进度对话框。

你必须要运行一个事件循环，连接canceled（）信号到一个槽，停止的操作，并且呼叫setValue（ ）间隔。例如：

  1.  // Operation constructor
  2.  Operation.Operation([QObject](qobject.html) *parent)
  3.      : [QObject](qobject.html)(parent), steps(0)
  4.  {
  5.      pd = new QProgressDialog("Operation in progress.", "Cancel", 0, 100);
  6.      connect(pd, SIGNAL(canceled()), this, SLOT(cancel()));
  7.      t = new [QTimer]($docs-qtimer.html)(this);
  8.      connect(t, SIGNAL(timeout()), this, SLOT(perform()));
  9.      t->start(0);
  10.  }
  12.  void Operation.perform()
  13.  {
  14.      pd->setValue(steps);
  15.      //... perform one percent of the operation
  16.      steps++;
  17.      if (steps > pd->maximum())
  18.          t->stop();
  19.  }
  21.  void Operation.cancel()
  22.  {
  23.      t->stop();
  24.      //... cleanup
  25.  }

在这两种模式的进度对话框可以通过使用自定义小部件更换子部件进行定制setLabel（ ）setBar（）和setCancelButton（ ） 。该功能setLabelText（）和setCancelButtonText（ ）设置显示的文本。

A progress dialog shown in the Plastique widget style.

Method Documentation

  1. QProgressDialog.__init__ (self, QWidget parent = None, Qt.WindowFlags flags = 0)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个进度对话框。

默认设置：

  • The label text is empty.
  • The cancel button text is (translated) “Cancel”.
  • minimum is 0;
  • maximum is 100

该parent参数是对话框的父控件。窗口部件标记，f，被传递到QDialog.QDialog（ ）构造函数。

See also setLabelText（ ）setCancelButtonText（ ）setCancelButton（ ）setMinimum（）和setMaximum（ ） 。

  1. QProgressDialog.__init__ (self, QString labelText, QString cancelButtonText, int minimum, int maximum, QWidget parent = None, Qt.WindowFlags flags = 0)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个进度对话框。

该labelText是用来提醒什么进展了用户的文本。

该cancelButtonText是上显示了取消按钮的文本。如果的QString （）传递则不会取消显示按钮。

该minimum和maximum是在步凡本进度对话框显示正在进行的操作数。例如，如果操作是检查50个文件，则该值的最小值是0 ，最大值是50 。在检查的第一个文件，调用的setValue （ 0 ） 。当每个文件处理调用setValue方法（ 1 ） ， setValue方法（ 2 ）等，检查的最后一个文件后，终于调用setValue方法（ 50 ） 。

该parent参数是对话框的父窗口部件。父，parent和窗口部件标记，f，被传递到QDialog.QDialog（ ）构造函数。

See also setLabelText（ ）setLabel（ ）setCancelButtonText（ ）setCancelButton（ ）setMinimum（）和setMaximum（ ） 。

  1. bool QProgressDialog.autoClose (self)
  1. bool QProgressDialog.autoReset (self)
  1. QProgressDialog.cancel (self)

这种方法也是一个Qt槽与C + +的签名void cancel()。

重置进度对话框。wasCanceled（ ）为真，直到进度对话框复位。进度对话框被隐藏。

  1. QProgressDialog.changeEvent (self, QEvent)

从重新实现QWidget.changeEvent（ ） 。

  1. QProgressDialog.closeEvent (self, QCloseEvent)

从重新实现QWidget.closeEvent（ ） 。

  1. QProgressDialog.forceShow (self)

显示已经启动，如果它仍然隐藏算法后的对话框minimumDuration毫秒过去了。

See also setMinimumDuration（ ） 。

  1. QString QProgressDialog.labelText (self)
  1. int QProgressDialog.maximum (self)
  1. int QProgressDialog.minimum (self)
  1. int QProgressDialog.minimumDuration (self)
  1. QProgressDialog.open (self)

这是一个重载函数。

在打开的对话框并连接其accepted（）信号到由指定的槽receiver和member。

该信号会从插槽中断开时，关闭对话框。

此功能被引入Qt的4.5 。

  1. QProgressDialog.open (self, QObject receiver, SLOT()SLOT() member)
  1. QProgressDialog.open (self, callable receiver)
  1. QProgressDialog.reset (self)

这种方法也是一个Qt槽与C + +的签名void reset()。

重置进度对话框。进度对话框被隐藏，如果autoClose（）是真实的。

See also setAutoClose（）和setAutoReset（ ） 。

  1. QProgressDialog.resizeEvent (self, QResizeEvent)

从重新实现QWidget.resizeEvent（ ） 。

  1. QProgressDialog.setAutoClose (self, bool b)
  1. QProgressDialog.setAutoReset (self, bool b)
  1. QProgressDialog.setBar (self, QProgressBar bar)

该bar说法有它的所有权转移给Qt的。

设置进度栏小工具，bar。进度对话框调整大小以适合。进度对话框需要的进度所有权bar这将在必要时不要使用在堆栈上分配一个进度条被删除，所以。

  1. QProgressDialog.setCancelButton (self, QPushButton button)

该button说法有它的所有权转移给Qt的。

设置取消按钮，按钮，cancelButton。进度对话框需要这个按钮将被删除必要时的所有权，所以不要传递一个对象，它是在栈上的地址，即使用新的（）来创建按钮。如果传递0则没有取消按钮会显示。

See also setCancelButtonText（ ） 。

  1. QProgressDialog.setCancelButtonText (self, QString)

这种方法也是一个Qt槽与C + +的签名void setCancelButtonText(const QString&)。

设置取消按钮的文本cancelButtonText。如果文本被设置为的QString （ ），那么它会导致取消按钮被隐藏和删除。

See also setCancelButton（ ） 。

  1. QProgressDialog.setLabel (self, QLabel label)

该label说法有它的所有权转移给Qt的。

设置标籤label。进度对话框调整大小以适合。标籤变成了进度对话框，并拥有将被删除必要的时候，所以不要在栈上传递一个对象的地址。

See also setLabelText（ ） 。

  1. QProgressDialog.setLabelText (self, QString)

这种方法也是一个Qt槽与C + +的签名void setLabelText(const QString&)。

  1. QProgressDialog.setMaximum (self, int maximum)

这种方法也是一个Qt槽与C + +的签名void setMaximum(int)。

  1. QProgressDialog.setMinimum (self, int minimum)

这种方法也是一个Qt槽与C + +的签名void setMinimum(int)。

  1. QProgressDialog.setMinimumDuration (self, int ms)

这种方法也是一个Qt槽与C + +的签名void setMinimumDuration(int)。

  1. QProgressDialog.setRange (self, int minimum, int maximum)

将进度对话框的最小值和最大值minimum和maximum元。

If maximum小于minimum，minimum成为唯一的合法值。

如果当前值超出了新的范围，进度对话框会重设reset（ ） 。

See also minimum和maximum。

  1. QProgressDialog.setValue (self, int progress)

这种方法也是一个Qt槽与C + +的签名void setValue(int)。

  1. QProgressDialog.showEvent (self, QShowEvent e)

从重新实现QWidget.showEvent（ ） 。

  1. QSize QProgressDialog.sizeHint (self)

从重新实现QWidget.sizeHint（ ） 。

返回适合的进度对话框中的内容大小。进度对话框调整自身大小的要求，所以你不应该需要自己调用这个函数。

  1. int QProgressDialog.value (self)
  1. bool QProgressDialog.wasCanceled (self)

Qt Signal Documentation

  1. void canceled ()

这是该信号的默认超载。

被点击了取消按钮时，这个信号被发射。它被连接到cancel（）槽的默认。

See also wasCanceled（ ） 。