# QProgressBar Class Reference ## [[QtGui](index.htm) module] 該QProgressBar部件提供水平或垂直進度條。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum Direction { TopToBottom, BottomToTop }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `Qt.Alignment alignment (self)` * `bool event (self, QEvent?e)` * `QString format (self)` * `initStyleOption (self, QStyleOptionProgressBar?option)` * `bool invertedAppearance (self)` * `bool isTextVisible (self)` * `int maximum (self)` * `int minimum (self)` * `QSize minimumSizeHint (self)` * `Qt.Orientation orientation (self)` * `paintEvent (self, QPaintEvent)` * `reset (self)` * `setAlignment (self, Qt.Alignment?alignment)` * `setFormat (self, QString?format)` * `setInvertedAppearance (self, bool?invert)` * `setMaximum (self, int?maximum)` * `setMinimum (self, int?minimum)` * `setOrientation (self, Qt.Orientation)` * `setRange (self, int?minimum, int?maximum)` * `setTextDirection (self, Direction?textDirection)` * `setTextVisible (self, bool?visible)` * `setValue (self, int?value)` * `QSize sizeHint (self)` * `QString text (self)` * `Direction textDirection (self)` * `int value (self)` ### Qt Signals * `void valueChanged (int)` * * * ## Detailed Description 該QProgressBar部件提供水平或垂直進度條。 一個進度條是用來給用戶的操作的進度指示，并安撫他們的應用程序仍在運行。 進度欄所使用的概念_steps_。你設置它通過指定最小和最大可能的步長值，它會顯示的步驟已經完成的百分比，當你以后給它當前的步長值。該百分比除以進度計算（[value](qprogressbar.html#value-prop)（） - [minimum](qprogressbar.html#minimum-prop)（） ）除以[maximum](qprogressbar.html#maximum-prop)（） - [minimum](qprogressbar.html#minimum-prop)（ ） 。 您可以指定最小和最大步數與[setMinimum](qprogressbar.html#minimum-prop)（）和setMaximum 。的步驟的當前數量設置與[setValue](qprogressbar.html#value-prop)（ ） 。進度條可以倒到開頭與[reset](qprogressbar.html#reset)（ ） 。 如果最小和最大兩個都設置為0 ，指示條顯示了一個忙閒指示，而不是步驟的百分比。使用時，這是有用的，例如，[QFtp](qftp.html) or [QNetworkAccessManager](qnetworkaccessmanager.html)下載項目時，他們無法確定正在下載的項目的大小。 |  | A progress bar shown in the Macintosh widget style. | |  | A progress bar shown in the Windows XP widget style. | |  | A progress bar shown in the Plastique widget style. | * * * ## Type Documentation ``` QProgressBar.Direction ``` 指定的閱讀方向[text](qprogressbar.html#text-prop)垂直進度條。 | Constant | Value | Description | | --- | --- | --- | | `QProgressBar.TopToBottom` | `0` | 該文本順時針旋轉90度。 | | `QProgressBar.BottomToTop` | `1` | 文本逆時針旋轉90度。 | 請注意，文字是否繪制取決于風格。目前CDE ， CleanLooks ，Motif和PLASTIQUE繪制文本。 Mac，Windows和WindowsXP的風格沒有。 這個枚舉被引入或修改的Qt 4.1 。 **See also** [textDirection](qprogressbar.html#textDirection-prop)。 * * * ## Method Documentation ``` QProgressBar.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個進度條給定的_parent_。 默認情況下，最小步長值被設置為0 ，最大值為100。 **See also** [setRange](qprogressbar.html#setRange)（ ） 。 ``` Qt.Alignment QProgressBar.alignment (self) ``` [ ``` bool QProgressBar.event (self, QEvent?e) ``` ](index.htm) [從重新實現](index.htm)[QObject.event](qobject.html#event)（ ） 。 ``` QString QProgressBar.format (self) ``` ``` QProgressBar.initStyleOption (self, QStyleOptionProgressBar?option) ``` 初始化_option_與其它的值[QProgressBar](qprogressbar.html)。當他們需要一個這種方法是有用的子類[QStyleOptionProgressBar](qstyleoptionprogressbar.html) or [QStyleOptionProgressBarV2](qstyleoptionprogressbarv2.html)，但不希望在所有的信息填寫自己。此功能將檢查的版本[QStyleOptionProgressBar](qstyleoptionprogressbar.html)并填寫了附加價值[QStyleOptionProgressBarV2](qstyleoptionprogressbarv2.html)。 **See also** [QStyleOption.initFrom](qstyleoption.html#initFrom)（ ） 。 ``` bool QProgressBar.invertedAppearance (self) ``` ``` bool QProgressBar.isTextVisible (self) ``` ``` int QProgressBar.maximum (self) ``` ``` int QProgressBar.minimum (self) ``` ``` QSize QProgressBar.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（ ） 。 ``` Qt.Orientation QProgressBar.orientation (self) ``` [ ``` QProgressBar.paintEvent (self, QPaintEvent) ``` ](qt.html#Orientation-enum) [從重新實現](qt.html#Orientation-enum)[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 ``` QProgressBar.reset (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void reset()`。 重置進度條。進度條“倒帶”，并表示沒有任何進展。 ``` QProgressBar.setAlignment (self, Qt.Alignment?alignment) ``` ``` QProgressBar.setFormat (self, QString?format) ``` ``` QProgressBar.setInvertedAppearance (self, bool?invert) ``` ``` QProgressBar.setMaximum (self, int?maximum) ``` 這種方法也是一個Qt槽與C + +的簽名`void setMaximum(int)`。 ``` QProgressBar.setMinimum (self, int?minimum) ``` 這種方法也是一個Qt槽與C + +的簽名`void setMinimum(int)`。 ``` QProgressBar.setOrientation (self, Qt.Orientation) ``` 這種方法也是一個Qt槽與C + +的簽名`void setOrientation(Qt::Orientation)`。 ``` QProgressBar.setRange (self, int?minimum, int?maximum) ``` 將進度條的最大值和最小值來_minimum_和_maximum_分別。 If _maximum_小于_minimum_，_minimum_成為唯一的合法值。 如果當前值超出了新的范圍，進度條帶復位[reset](qprogressbar.html#reset)（ ） 。 **See also** [minimum](qprogressbar.html#minimum-prop)和[maximum](qprogressbar.html#maximum-prop)。 ``` QProgressBar.setTextDirection (self, Direction?textDirection) ``` ``` QProgressBar.setTextVisible (self, bool?visible) ``` ``` QProgressBar.setValue (self, int?value) ``` 這種方法也是一個Qt槽與C + +的簽名`void setValue(int)`。 ``` QSize QProgressBar.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` QString QProgressBar.text (self) ``` ``` Direction QProgressBar.textDirection (self) ``` [ ``` int QProgressBar.value (self) ``` * * * ## Qt Signal Documentation ``` void valueChanged (int) ``` 這是該信號的默認超載。 當進度條改變顯示的值這個信號被發射。_value_是通過進度條顯示的新值。 ](qprogressbar.html#Direction-enum)