QSpinBox Class Reference · PyQt4 中文文檔

# QSpinBox Class Reference ## [[QtGui](index.htm) module] 該QSpinBox類提供了一個微調框控件。[More...](#details) 繼承[QAbstractSpinBox](qabstractspinbox.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `QString cleanText (self)` * `bool event (self, QEvent?e)` * `QString?str fixup (self, QString?str)` * `fixup (self, QString?str)` * `int maximum (self)` * `int minimum (self)` * `QString prefix (self)` * `setMaximum (self, int?max)` * `setMinimum (self, int?min)` * `setPrefix (self, QString?p)` * `setRange (self, int?min, int?max)` * `setSingleStep (self, int?val)` * `setSuffix (self, QString?s)` * `setValue (self, int?val)` * `int singleStep (self)` * `QString suffix (self)` * `QString textFromValue (self, int?v)` * `(QValidator.State, QString?input, int?pos) validate (self, QString?input, int?pos)` * `(QValidator.State, int?pos) validate (self, QString?input, int?pos)` * `int value (self)` * `int valueFromText (self, QString?text)` ### Qt Signals * `void valueChanged (int)` * `void valueChanged (const QString&)` * * * ## Detailed Description 該QSpinBox類提供了一個微調框控件。 QSpinBox是專門用來處理整數和值（例如，月份名稱）的離散套;使用[QDoubleSpinBox](qdoublespinbox.html)浮點值。 QSpinBox允許用戶通過點擊向上/向下鍵或按上/下鍵盤上的增加/減少當前顯示的值來選擇一個值。用戶也可以輸入值手動。旋轉框支持整數值，但可以擴展到使用不同的字符串與[validate](qspinbox.html#validate)（）[textFromValue](qspinbox.html#textFromValue)（）和[valueFromText](qspinbox.html#valueFromText)（）。每次值更改QSpinBox放出[valueChanged](qspinbox.html#valueChanged)（）信號。電流值可與提取[value](qspinbox.html#value-prop)（），并設置用[setValue](qspinbox.html#value-prop)（）。點擊向上/向下按鈕，或者使用鍵盤快捷鍵的向上和向下箭頭會增加或減少步大小的當前值[singleStep](qspinbox.html#singleStep-prop)（）。如果你想改變這種行為，您可以重新實現虛函數[stepBy](qabstractspinbox.html#stepBy)（）。的最低和最高值和步長可以使用構造函數之一被設置，并且可以用以后改變[setMinimum](qspinbox.html#minimum-prop)（）[setMaximum](qspinbox.html#maximum-prop)（）和[setSingleStep](qspinbox.html#singleStep-prop)（）。大多數旋轉框是有方向性的，但QSpinBox也可以作為一個圓形的旋轉框，即如果經營范圍是0-99 ，電流值是99 ，點擊“向上”將給0，如果[wrapping](qabstractspinbox.html#wrapping-prop)（）設置為True 。使用[setWrapping](qabstractspinbox.html#wrapping-prop)（），如果你想圓行為。所顯示的值可以預先考慮并附加任意的字符串表示，例如，貨幣或計量單位。看[setPrefix](qspinbox.html#prefix-prop)（）和[setSuffix](qspinbox.html#suffix-prop)（）。在旋轉框中的文本與檢索[text](qabstractspinbox.html#text-prop)（）（包括任何[prefix](qspinbox.html#prefix-prop)（）和[suffix](qspinbox.html#suffix-prop)（）），或用[cleanText](qspinbox.html#cleanText-prop)（）（其具有不[prefix](qspinbox.html#prefix-prop)（），不[suffix](qspinbox.html#suffix-prop)（）和沒有前導或尾隨空白）。常常希望給用戶一個特殊（通常默認）選擇除數值的范圍。看[setSpecialValueText](qabstractspinbox.html#specialValueText-prop)（）對于如何與QSpinBox做到這一點。 | ![Screenshot of a Windows XP spin box](https://img.kancloud.cn/15/5b/155bdaf298a21081f326957d31e9b2ce_314x30.png) | A spin box shown in the [Windows XP widget style](index.htm). | | ![Screenshot of a Plastique spin box](https://img.kancloud.cn/91/54/91545d0bc928004ed0145d30b9e6e544_211x33.png) | A spin box shown in the [Plastique widget style](index.htm). | | ![Screenshot of a Macintosh spin box](https://img.kancloud.cn/a7/6a/a76a5d88351b724e7744dd4b30fc7306_300x39.png) | A spin box shown in the [Macintosh widget style](index.htm). | ### Subclassing QSpinBox 如果使用[prefix](qspinbox.html#prefix-prop)（）[suffix](qspinbox.html#suffix-prop)（）和[specialValueText](qabstractspinbox.html#specialValueText-prop)（）不提供足夠的控制，你的子類QSpinBox和重新實現[valueFromText](qspinbox.html#valueFromText)（）和[textFromValue](qspinbox.html#textFromValue)（）。例如，下面是一個自定義的旋轉框，允許用戶輸入圖標大小（例如， “ 32× 32” ）的代碼： ``` int IconSizeSpinBox.valueFromText(const [QString](qstring.html) &text) const { [QRegExp](qregexp.html) regExp(tr("(\\d+)(\\s*[xx]\\s*\\d+)?")); if (regExp.exactMatch(text)) { return regExp.cap(1).toInt(); } else { return 0; } } [QString](qstring.html) IconSizeSpinBox.textFromValue(int value) const { return tr("%1 x %1").arg(value); } ``` 請參閱[Icons](index.htm)示例的完整源代碼。 * * * ## Method Documentation ``` QSpinBox.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個微調框以0為最低值， 99為最高值，為1的步長值。的值被初始設置為0 。這是對父_parent_。 **See also** [setMinimum](qspinbox.html#minimum-prop)（）[setMaximum](qspinbox.html#maximum-prop)（）和[setSingleStep](qspinbox.html#singleStep-prop)（）。 ``` QString QSpinBox.cleanText (self) ``` ``` bool QSpinBox.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` QString?str QSpinBox.fixup (self, QString?str) ``` 從重新實現[QAbstractSpinBox.fixup](qabstractspinbox.html#fixup)（）。 ``` QSpinBox.fixup (self, QString?str) ``` ``` int QSpinBox.maximum (self) ``` ``` int QSpinBox.minimum (self) ``` ``` QString QSpinBox.prefix (self) ``` ``` QSpinBox.setMaximum (self, int?max) ``` ``` QSpinBox.setMinimum (self, int?min) ``` ``` QSpinBox.setPrefix (self, QString?p) ``` ``` QSpinBox.setRange (self, int?min, int?max) ``` 便利的功能設置_minimum_和_maximum_值與一個函數調用。 ``` setRange(minimum, maximum); ``` 相當于： ``` setMinimum(minimum); setMaximum(maximum); ``` **See also** [minimum](qspinbox.html#minimum-prop)和[maximum](qspinbox.html#maximum-prop)。 ``` QSpinBox.setSingleStep (self, int?val) ``` ``` QSpinBox.setSuffix (self, QString?s) ``` ``` QSpinBox.setValue (self, int?val) ``` 這種方法也是一個Qt槽與C + +的簽名`void setValue(int)`。 ``` int QSpinBox.singleStep (self) ``` ``` QString QSpinBox.suffix (self) ``` ``` QString QSpinBox.textFromValue (self, int?v) ``` 這個虛函數所使用的旋轉框時，它需要顯示給定的_value_。默認實現返回一個包含一個字符串_value_用印在標準方式[QWidget.locale](qwidget.html#locale-prop)（）。 toString（）方法，但與千位分隔符去掉。重新實現可能返回任何東西。（參見在詳細描述中的示例。）注意：[QSpinBox](qspinbox.html)不會調用此函數[specialValueText](qabstractspinbox.html#specialValueText-prop)（）和既不[prefix](qspinbox.html#prefix-prop)（）也不[suffix](qspinbox.html#suffix-prop)（）應包括在返回值。如果你重新實現這一點，您可能還需要重新實現[valueFromText](qspinbox.html#valueFromText)（）和[validate](qspinbox.html#validate)（） **See also** [valueFromText](qspinbox.html#valueFromText)（）[validate](qspinbox.html#validate)（）和[QLocale.groupSeparator](qlocale.html#groupSeparator)（）。 ``` (QValidator.State, QString?input, int?pos) QSpinBox.validate (self, QString?input, int?pos) ``` 從重新實現[QAbstractSpinBox.validate](qabstractspinbox.html#validate)（）。 ``` (QValidator.State, int?pos) QSpinBox.validate (self, QString?input, int?pos) ``` ``` int QSpinBox.value (self) ``` ``` int QSpinBox.valueFromText (self, QString?text) ``` 這個虛函數所使用的旋轉框時，它需要解釋_text_由用戶輸入的值。這需要在一個非數字的方式顯示數字顯示框的值的子類需要重寫本函數。注意：[QSpinBox](qspinbox.html)手柄[specialValueText](qabstractspinbox.html#specialValueText-prop)（）分開，此功能只關心其他值。 **See also** [textFromValue](qspinbox.html#textFromValue)（）和[validate](qspinbox.html#validate)（）。 * * * ## Qt Signal Documentation ``` void valueChanged (int) ``` 這是該信號的默認超載。這個信號被發射時旋轉框的值被改變。新值的整數值傳遞_i_。 ``` void valueChanged (const QString&) ``` 這是一個重載函數。新的值是逐字傳遞_text_沒有[prefix](qspinbox.html#prefix-prop)（）或[suffix](qspinbox.html#suffix-prop)（）。