# QAbstractSpinBox Class Reference ## [[QtGui](index.htm) module] 該QAbstractSpinBox類提供了一個紡紗器和一個行編輯，以顯示值。[More...](#details) 繼承[QWidget](qwidget.html)。 通過繼承[QDateTimeEdit](qdatetimeedit.html)，[QDoubleSpinBox](qdoublespinbox.html)和[QSpinBox](qspinbox.html)。 ### Types * `enum ButtonSymbols { UpDownArrows, PlusMinus, NoButtons }` * `enum CorrectionMode { CorrectToPreviousValue, CorrectToNearestValue }` * `class **[StepEnabled](index.htm)**` * `enum StepEnabledFlag { StepNone, StepUpEnabled, StepDownEnabled }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `Qt.Alignment alignment (self)` * `ButtonSymbols buttonSymbols (self)` * `changeEvent (self, QEvent?e)` * `clear (self)` * `closeEvent (self, QCloseEvent?e)` * `contextMenuEvent (self, QContextMenuEvent?e)` * `CorrectionMode correctionMode (self)` * `bool event (self, QEvent?event)` * `QString?input fixup (self, QString?input)` * `fixup (self, QString?input)` * `focusInEvent (self, QFocusEvent?e)` * `focusOutEvent (self, QFocusEvent?e)` * `bool hasAcceptableInput (self)` * `bool hasFrame (self)` * `hideEvent (self, QHideEvent?e)` * `initStyleOption (self, QStyleOptionSpinBox?option)` * `QVariant inputMethodQuery (self, Qt.InputMethodQuery)` * `interpretText (self)` * `bool isAccelerated (self)` * `bool isReadOnly (self)` * `bool keyboardTracking (self)` * `keyPressEvent (self, QKeyEvent?e)` * `keyReleaseEvent (self, QKeyEvent?e)` * `QLineEdit lineEdit (self)` * `QSize minimumSizeHint (self)` * `mouseMoveEvent (self, QMouseEvent?e)` * `mousePressEvent (self, QMouseEvent?e)` * `mouseReleaseEvent (self, QMouseEvent?e)` * `paintEvent (self, QPaintEvent?e)` * `resizeEvent (self, QResizeEvent?e)` * `selectAll (self)` * `setAccelerated (self, bool?on)` * `setAlignment (self, Qt.Alignment?flag)` * `setButtonSymbols (self, ButtonSymbols?bs)` * `setCorrectionMode (self, CorrectionMode?cm)` * `setFrame (self, bool)` * `setKeyboardTracking (self, bool?kt)` * `setLineEdit (self, QLineEdit?e)` * `setReadOnly (self, bool?r)` * `setSpecialValueText (self, QString?s)` * `setWrapping (self, bool?w)` * `showEvent (self, QShowEvent?e)` * `QSize sizeHint (self)` * `QString specialValueText (self)` * `stepBy (self, int?steps)` * `stepDown (self)` * `StepEnabled stepEnabled (self)` * `stepUp (self)` * `QString text (self)` * `timerEvent (self, QTimerEvent?e)` * `(QValidator.State, QString?input, int?pos) validate (self, QString?input, int?pos)` * `(QValidator.State, int?pos) validate (self, QString?input, int?pos)` * `wheelEvent (self, QWheelEvent?e)` * `bool wrapping (self)` ### Qt Signals * `void editingFinished ()` * * * ## Detailed Description 該QAbstractSpinBox類提供了一個紡紗器和一個行編輯，以顯示值。 這個類被設計成一個共同的超類的小部件一樣[QSpinBox](qspinbox.html)，[QDoubleSpinBox](qdoublespinbox.html)和[QDateTimeEdit](qdatetimeedit.html) 下面是類的主要屬性： 1. [text](qabstractspinbox.html#text-prop)：表示顯示在QAbstractSpinBox的文本。 2. [alignment](qabstractspinbox.html#alignment-prop)：在QAbstractSpinBox文本的對齊方式。 3. [wrapping](qabstractspinbox.html#wrapping-prop)：無論QAbstractSpinBox從最小值換到最大值，正相反。 QAbstractSpinBox提供了一個虛擬[stepBy](qabstractspinbox.html#stepBy)每當用戶觸發一個步驟（）函數被調用。這個函數接受一個整數值來表示多少步拍攝。例如壓制[Qt.Key_Down](qt.html#Key-enum)將觸發調用stepBy （-1 ） 。 QAbstractSpinBox還提供了一個虛函數[stepEnabled](qabstractspinbox.html#stepEnabled)（ ）來判斷是否加強向上/向下是允許在任何時候。該函數返回一個bitset[StepEnabled](qabstractspinbox.html#StepEnabledFlag-enum)。 * * * ## Type Documentation ``` QAbstractSpinBox.ButtonSymbols ``` 該枚舉類型描述了可以在旋轉框中顯示的按鈕的符號。   | Constant | Value | Description | | --- | --- | --- | | `QAbstractSpinBox.UpDownArrows` | `0` | 小箭頭的經典款式。 | | `QAbstractSpinBox.PlusMinus` | `1` | **+**和**-**符號。 | | `QAbstractSpinBox.NoButtons` | `2` | 不顯示按鈕。 | **See also** [QAbstractSpinBox.buttonSymbols](qabstractspinbox.html#buttonSymbols-prop)。 ``` QAbstractSpinBox.CorrectionMode ``` 該枚舉類型描述模式的紡紗器將用來糾正[Intermediate](qvalidator.html#State-enum)如果編輯結束值。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractSpinBox.CorrectToPreviousValue` | `0` | 紡紗器將恢復到最后的有效價值。 | | `QAbstractSpinBox.CorrectToNearestValue` | `1` | 紡紗器將恢復到最接近的有效值。 | **See also** [correctionMode](qabstractspinbox.html#correctionMode-prop)。 ``` QAbstractSpinBox.StepEnabledFlag ``` | Constant | Value | | --- | --- | | `QAbstractSpinBox.StepNone` | `0x00` | | `QAbstractSpinBox.StepUpEnabled` | `0x01` | | `QAbstractSpinBox.StepDownEnabled` | `0x02` | 該StepEnabled類型是一個typedef為[QFlags](index.htm)\u003cStepEnabledFlag\u003e 。它存儲StepEnabledFlag值的或組合。 * * * ## Method Documentation ``` QAbstractSpinBox.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個抽象的紡紗用給定的_parent_使用默認[wrapping](qabstractspinbox.html#wrapping-prop)和[alignment](qabstractspinbox.html#alignment-prop)屬性。 ``` Qt.Alignment QAbstractSpinBox.alignment (self) ``` [](index.htm) ``` ButtonSymbols QAbstractSpinBox.buttonSymbols (self) ``` [ ``` QAbstractSpinBox.changeEvent (self, QEvent?e) ``` ](qabstractspinbox.html#ButtonSymbols-enum) [從重新實現](qabstractspinbox.html#ButtonSymbols-enum)[QWidget.changeEvent](qwidget.html#changeEvent)（ ） 。 ``` QAbstractSpinBox.clear (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void clear()`。 清除所有文本，但前綴和后綴的lineedit 。 ``` QAbstractSpinBox.closeEvent (self, QCloseEvent?e) ``` 從重新實現[QWidget.closeEvent](qwidget.html#closeEvent)（ ） 。 ``` QAbstractSpinBox.contextMenuEvent (self, QContextMenuEvent?e) ``` 從重新實現[QWidget.contextMenuEvent](qwidget.html#contextMenuEvent)（ ） 。 ``` CorrectionMode QAbstractSpinBox.correctionMode (self) ``` [ ``` bool QAbstractSpinBox.event (self, QEvent?event) ``` ](qabstractspinbox.html#CorrectionMode-enum) [從重新實現](qabstractspinbox.html#CorrectionMode-enum)[QObject.event](qobject.html#event)（ ） 。 ``` QString?input QAbstractSpinBox.fixup (self, QString?input) ``` 這個虛函數被調用的[QAbstractSpinBox](qabstractspinbox.html)如果_input_不驗證，[QValidator.Acceptable](qvalidator.html#State-enum)返回時，按下或[interpretText](qabstractspinbox.html#interpretText)（）被調用。它會嘗試改變文本，以便它是有效的。重新實現在各個子類。 ``` QAbstractSpinBox.fixup (self, QString?input) ``` ``` QAbstractSpinBox.focusInEvent (self, QFocusEvent?e) ``` 從重新實現[QWidget.focusInEvent](qwidget.html#focusInEvent)（ ） 。 ``` QAbstractSpinBox.focusOutEvent (self, QFocusEvent?e) ``` 從重新實現[QWidget.focusOutEvent](qwidget.html#focusOutEvent)（ ） 。 ``` bool QAbstractSpinBox.hasAcceptableInput (self) ``` ``` bool QAbstractSpinBox.hasFrame (self) ``` ``` QAbstractSpinBox.hideEvent (self, QHideEvent?e) ``` 從重新實現[QWidget.hideEvent](qwidget.html#hideEvent)（ ） 。 ``` QAbstractSpinBox.initStyleOption (self, QStyleOptionSpinBox?option) ``` 初始化_option_與其它的值[QSpinBox](qspinbox.html)。當他們需要一個這種方法是有用的子類[QStyleOptionSpinBox](qstyleoptionspinbox.html)，但不希望在所有的信息填寫自己。 **See also** [QStyleOption.initFrom](qstyleoption.html#initFrom)（ ） 。 ``` QVariant QAbstractSpinBox.inputMethodQuery (self, Qt.InputMethodQuery) ``` 從重新實現[QWidget.inputMethodQuery](qwidget.html#inputMethodQuery)（ ） 。 ``` QAbstractSpinBox.interpretText (self) ``` 這個函數把數值輸入框的文字。如果該值已經從去年的解釋改變了它會發出信號。 ``` bool QAbstractSpinBox.isAccelerated (self) ``` ``` bool QAbstractSpinBox.isReadOnly (self) ``` ``` bool QAbstractSpinBox.keyboardTracking (self) ``` ``` QAbstractSpinBox.keyPressEvent (self, QKeyEvent?e) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（ ） 。 這個函數處理鍵盤輸入。 下面的鍵被特別處理： | Enter/Return | This will reinterpret the text and emit a signal even if the value has not changed since last time a signal was emitted. | | Up | This will invoke stepBy(1) | | Down | This will invoke stepBy(-1) | | Page up | This will invoke stepBy(10) | | Page down | This will invoke stepBy(-10) | ``` QAbstractSpinBox.keyReleaseEvent (self, QKeyEvent?e) ``` 從重新實現[QWidget.keyReleaseEvent](qwidget.html#keyReleaseEvent)（ ） 。 ``` QLineEdit QAbstractSpinBox.lineEdit (self) ``` [ 這個函數返回一個指針，指向旋轉框的行編輯。 ](qlineedit.html) [**See also**](qlineedit.html) [setLineEdit](qabstractspinbox.html#setLineEdit)（ ） 。 ``` QSize QAbstractSpinBox.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（ ） 。 ``` QAbstractSpinBox.mouseMoveEvent (self, QMouseEvent?e) ``` 從重新實現[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（ ） 。 ``` QAbstractSpinBox.mousePressEvent (self, QMouseEvent?e) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（ ） 。 ``` QAbstractSpinBox.mouseReleaseEvent (self, QMouseEvent?e) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（ ） 。 ``` QAbstractSpinBox.paintEvent (self, QPaintEvent?e) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 ``` QAbstractSpinBox.resizeEvent (self, QResizeEvent?e) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 ``` QAbstractSpinBox.selectAll (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void selectAll()`。 選擇在紡紗除了前綴和后綴的所有文本。 ``` QAbstractSpinBox.setAccelerated (self, bool?on) ``` ``` QAbstractSpinBox.setAlignment (self, Qt.Alignment?flag) ``` ``` QAbstractSpinBox.setButtonSymbols (self, ButtonSymbols?bs) ``` ``` QAbstractSpinBox.setCorrectionMode (self, CorrectionMode?cm) ``` ``` QAbstractSpinBox.setFrame (self, bool) ``` ``` QAbstractSpinBox.setKeyboardTracking (self, bool?kt) ``` ``` QAbstractSpinBox.setLineEdit (self, QLineEdit?e) ``` 該_e_說法有它的所有權轉移給Qt的。 設置紡紗是的行編輯_lineEdit_而不是當前行編輯控件。_lineEdit_不能為0 。 [QAbstractSpinBox](qabstractspinbox.html)采用新lineEdit的所有權 If [QLineEdit.validator](qlineedit.html#validator)（ ）為_lineEdit_返回0 ，紡紗器的內部驗證器將上線的編輯設置。 **See also** [lineEdit](qabstractspinbox.html#lineEdit)（ ） 。 ``` QAbstractSpinBox.setReadOnly (self, bool?r) ``` ``` QAbstractSpinBox.setSpecialValueText (self, QString?s) ``` ``` QAbstractSpinBox.setWrapping (self, bool?w) ``` ``` QAbstractSpinBox.showEvent (self, QShowEvent?e) ``` 從重新實現[QWidget.showEvent](qwidget.html#showEvent)（ ） 。 ``` QSize QAbstractSpinBox.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` QString QAbstractSpinBox.specialValueText (self) ``` ``` QAbstractSpinBox.stepBy (self, int?steps) ``` 只要用戶觸發了一步虛函數時被調用。該_steps_參數表示要走多少步拍攝，如壓制[Qt.Key_Down](qt.html#Key-enum)將觸發一個呼叫到stepBy （-1 ），而壓[Qt.Key_Prior](qt.html#Key-enum)將觸發調用stepBy （ 10 ） 。 如果子類[QAbstractSpinBox](qabstractspinbox.html)你必須重新實現此功能。注意，這個函數被調用，即使所得到的值將是最小值和最大值的范圍之外。這是這個函數的任務來處理這些情況。 ``` QAbstractSpinBox.stepDown (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void stepDown()`。 下臺一linestep調用這個插槽是類似于調用stepBy （-1 ） ; **See also** [stepBy](qabstractspinbox.html#stepBy)（）和[stepUp](qabstractspinbox.html#stepUp)（ ） 。 ``` StepEnabled QAbstractSpinBox.stepEnabled (self) ``` [ 虛擬函數，確定是否步進上下是合法的在任何給定時間。 ](index.htm) [向上箭頭將被描繪成禁止，除非（ stepEnabled （ ??） ＆](index.htm)[StepUpEnabled](qabstractspinbox.html#StepEnabledFlag-enum)！） = 0 。 默認實現將返回（[StepUpEnabled](qabstractspinbox.html#StepEnabledFlag-enum)|[StepDownEnabled](qabstractspinbox.html#StepEnabledFlag-enum)） ，如果包裝被打開。否則它會返回[StepDownEnabled](qabstractspinbox.html#StepEnabledFlag-enum)如果值是\u003e最小（ ）與OR'ed[StepUpEnabled](qabstractspinbox.html#StepEnabledFlag-enum)如果值\u003c最大（ ） 。 如果子類[QAbstractSpinBox](qabstractspinbox.html)您將需要重新實現這個函數。 **See also** [QSpinBox.minimum](qspinbox.html#minimum-prop)（ ）[QSpinBox.maximum](qspinbox.html#maximum-prop)（）和[wrapping](qabstractspinbox.html#wrapping-prop)（ ） 。 ``` QAbstractSpinBox.stepUp (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void stepUp()`。 臺階由一個linestep調用這個插槽是類似于調用stepBy （ 1 ） ; **See also** [stepBy](qabstractspinbox.html#stepBy)（）和[stepDown](qabstractspinbox.html#stepDown)（ ） 。 ``` QString QAbstractSpinBox.text (self) ``` ``` QAbstractSpinBox.timerEvent (self, QTimerEvent?e) ``` 從重新實現[QObject.timerEvent](qobject.html#timerEvent)（ ） 。 ``` (QValidator.State, QString?input, int?pos) QAbstractSpinBox.validate (self, QString?input, int?pos) ``` 這個虛函數被調用的[QAbstractSpinBox](qabstractspinbox.html)以確定是否_input_是有效的。該_pos_參數表示字符串中的位置。重新實現在各個子類。 ``` (QValidator.State, int?pos) QAbstractSpinBox.validate (self, QString?input, int?pos) ``` ``` QAbstractSpinBox.wheelEvent (self, QWheelEvent?e) ``` 從重新實現[QWidget.wheelEvent](qwidget.html#wheelEvent)（ ） 。 ``` bool QAbstractSpinBox.wrapping (self) ``` * * * ## Qt Signal Documentation ``` void editingFinished () ``` 這是該信號的默認超載。 這個信號被發射編輯完成。這種情況發生在紡紗器失去焦點時按Enter鍵。