QAbstractSlider Class Reference · PyQt4 中文文檔

# QAbstractSlider Class Reference ## [[QtGui](index.htm) module] 該QAbstractSlider類提供了一個范圍內的整數值。[More...](#details) 繼承[QWidget](qwidget.html)。通過繼承[QDial](qdial.html)，[QScrollBar](qscrollbar.html)和[QSlider](qslider.html)。 ### Types * `enum SliderAction { SliderNoAction, SliderSingleStepAdd, SliderSingleStepSub, SliderPageStepAdd, ..., SliderMove }` * `enum SliderChange { SliderRangeChange, SliderOrientationChange, SliderStepsChange, SliderValueChange }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `changeEvent (self, QEvent?e)` * `bool event (self, QEvent?e)` * `bool hasTracking (self)` * `bool invertedAppearance (self)` * `bool invertedControls (self)` * `bool isSliderDown (self)` * `keyPressEvent (self, QKeyEvent?ev)` * `int maximum (self)` * `int minimum (self)` * `Qt.Orientation orientation (self)` * `int pageStep (self)` * `SliderAction repeatAction (self)` * `setInvertedAppearance (self, bool)` * `setInvertedControls (self, bool)` * `setMaximum (self, int)` * `setMinimum (self, int)` * `setOrientation (self, Qt.Orientation)` * `setPageStep (self, int)` * `setRange (self, int?min, int?max)` * `setRepeatAction (self, SliderAction?action, int?thresholdTime?=?500, int?repeatTime?=?50)` * `setSingleStep (self, int)` * `setSliderDown (self, bool)` * `setSliderPosition (self, int)` * `setTracking (self, bool?enable)` * `setValue (self, int)` * `int singleStep (self)` * `sliderChange (self, SliderChange?change)` * `int sliderPosition (self)` * `timerEvent (self, QTimerEvent)` * `triggerAction (self, SliderAction?action)` * `int value (self)` * `wheelEvent (self, QWheelEvent?e)` ### Qt Signals * `void actionTriggered (int)` * `void rangeChanged (int,int)` * `void sliderMoved (int)` * `void sliderPressed ()` * `void sliderReleased ()` * `void valueChanged (int)` * * * ## Detailed Description 該QAbstractSlider類提供了一個范圍內的整數值。這個類被設計成一個共同的超類的小部件一樣[QScrollBar](qscrollbar.html)，[QSlider](qslider.html)和[QDial](qdial.html)。下面是類的主要屬性： 1. [value](qabstractslider.html#value-prop)：有界整數QAbstractSlider維護。 2. [minimum](qabstractslider.html#minimum-prop)：盡可能低的值。 3. [maximum](qabstractslider.html#maximum-prop)：可能的最高值。 4. [singleStep](qabstractslider.html#singleStep-prop)：是一個抽象的滑塊提供，通常越小的兩個自然步驟，對應于按箭頭鍵的用戶。 5. [pageStep](qabstractslider.html#pageStep-prop)：是一個抽象的滑塊提供，通常較大的兩個自然步驟，相當于按壓上下翻頁的用戶。 6. [tracking](qabstractslider.html#tracking-prop)：滑塊跟蹤是否被啟用。 7. [sliderPosition](qabstractslider.html#sliderPosition-prop)：滑塊的當前位置。如果[tracking](qabstractslider.html#tracking-prop)已啟用（默認值），這是相同的[value](qabstractslider.html#value-prop)。統一性（1）可被看作第三步長。[setValue](qabstractslider.html#value-prop)（）可讓您在允許的范圍內設定的電流值任意整數，而不僅僅是[minimum](qabstractslider.html#minimum-prop)（）+_n_*[singleStep](qabstractslider.html#singleStep-prop)（）為整數值_n_。一些小部件可能會允許用戶設置任何價值可言，有些人可能只是提供的倍數[singleStep](qabstractslider.html#singleStep-prop)（）或[pageStep](qabstractslider.html#pageStep-prop)（）。 QAbstractSlider發出一套全面的信號： | Signal | Emitted when | | --- | --- | | [valueChanged](qabstractslider.html#valueChanged)() | the value has changed. The [tracking](qabstractslider.html#tracking-prop) determines whether this signal is emitted during user interaction. | | [sliderPressed](qabstractslider.html#sliderPressed)() | the user starts to drag the slider. | | [sliderMoved](qabstractslider.html#sliderMoved)() | the user drags the slider. | | [sliderReleased](qabstractslider.html#sliderReleased)() | the user releases the slider. | | [actionTriggered](qabstractslider.html#actionTriggered)() | a slider action was triggerd. | | [rangeChanged](qabstractslider.html#rangeChanged)() | a the range has changed. | QAbstractSlider提供了一個虛擬[sliderChange](qabstractslider.html#sliderChange)（）函數，是非常適合用于更新滑塊的屏幕上的表示。通過調用[triggerAction](qabstractslider.html#triggerAction)（），子類觸發滑塊動作。兩個輔助函數[QStyle.sliderPositionFromValue](qstyle.html#sliderPositionFromValue)（）和[QStyle.sliderValueFromPosition](qstyle.html#sliderValueFromPosition)（）幫助子類和樣式映射屏幕坐標到邏輯范圍值。 * * * ## Type Documentation ``` QAbstractSlider.SliderAction ``` | Constant | Value | | --- | --- | | `QAbstractSlider.SliderNoAction` | `0` | | `QAbstractSlider.SliderSingleStepAdd` | `1` | | `QAbstractSlider.SliderSingleStepSub` | `2` | | `QAbstractSlider.SliderPageStepAdd` | `3` | | `QAbstractSlider.SliderPageStepSub` | `4` | | `QAbstractSlider.SliderToMinimum` | `5` | | `QAbstractSlider.SliderToMaximum` | `6` | | `QAbstractSlider.SliderMove` | `7` | ``` QAbstractSlider.SliderChange ``` | Constant | Value | | --- | --- | | `QAbstractSlider.SliderRangeChange` | `0` | | `QAbstractSlider.SliderOrientationChange` | `1` | | `QAbstractSlider.SliderStepsChange` | `2` | | `QAbstractSlider.SliderValueChange` | `3` | * * * ## Method Documentation ``` QAbstractSlider.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個抽象的滑塊。該_parent_參數被發送到[QWidget](qwidget.html)構造函數。該[minimum](qabstractslider.html#minimum-prop)缺省值為0 ，則[maximum](qabstractslider.html#maximum-prop)為99，用[singleStep](qabstractslider.html#singleStep-prop)1尺寸和[pageStep](qabstractslider.html#pageStep-prop)10的尺寸，和一個初始[value](qabstractslider.html#value-prop)0 。 ``` QAbstractSlider.changeEvent (self, QEvent?e) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（）。 ``` bool QAbstractSlider.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（）。 ``` bool QAbstractSlider.hasTracking (self) ``` ``` bool QAbstractSlider.invertedAppearance (self) ``` ``` bool QAbstractSlider.invertedControls (self) ``` ``` bool QAbstractSlider.isSliderDown (self) ``` ``` QAbstractSlider.keyPressEvent (self, QKeyEvent?ev) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（）。 ``` int QAbstractSlider.maximum (self) ``` ``` int QAbstractSlider.minimum (self) ``` ``` Qt.Orientation QAbstractSlider.orientation (self) ``` [ ``` int QAbstractSlider.pageStep (self) ``` ](qt.html#Orientation-enum) ``` SliderAction QAbstractSlider.repeatAction (self) ``` [ 返回當前重復動作。 ](qabstractslider.html#SliderAction-enum) [**See also**](qabstractslider.html#SliderAction-enum) [setRepeatAction](qabstractslider.html#setRepeatAction)（）。 ``` QAbstractSlider.setInvertedAppearance (self, bool) ``` ``` QAbstractSlider.setInvertedControls (self, bool) ``` ``` QAbstractSlider.setMaximum (self, int) ``` ``` QAbstractSlider.setMinimum (self, int) ``` ``` QAbstractSlider.setOrientation (self, Qt.Orientation) ``` 這種方法也是一個Qt槽與C + +的簽名`void setOrientation(Qt::Orientation)`。 ``` QAbstractSlider.setPageStep (self, int) ``` ``` QAbstractSlider.setRange (self, int?min, int?max) ``` 設置滑塊的最小值為_min_其最大到_max_。 If _max_小于_min_，_min_成為唯一的合法值。 **See also** [minimum](qabstractslider.html#minimum-prop)和[maximum](qabstractslider.html#maximum-prop)。 ``` QAbstractSlider.setRepeatAction (self, SliderAction?action, int?thresholdTime?=?500, int?repeatTime?=?50) ``` 套動作_action_要的時間間隔重復地觸發_repeatTime_，的一個初始延遲后_thresholdTime_。 **See also** [triggerAction](qabstractslider.html#triggerAction)（）和[repeatAction](qabstractslider.html#repeatAction)（）。 ``` QAbstractSlider.setSingleStep (self, int) ``` ``` QAbstractSlider.setSliderDown (self, bool) ``` ``` QAbstractSlider.setSliderPosition (self, int) ``` ``` QAbstractSlider.setTracking (self, bool?enable) ``` ``` QAbstractSlider.setValue (self, int) ``` 這種方法也是一個Qt槽與C + +的簽名`void setValue(int)`。 ``` int QAbstractSlider.singleStep (self) ``` ``` QAbstractSlider.sliderChange (self, SliderChange?change) ``` 重新實現這個虛函數來跟蹤滑塊的變化，如[SliderRangeChange](qabstractslider.html#SliderChange-enum)，[SliderOrientationChange](qabstractslider.html#SliderChange-enum)，[SliderStepsChange](qabstractslider.html#SliderChange-enum)或[SliderValueChange](qabstractslider.html#SliderChange-enum)。默認實現只更新顯示，而忽略了_change_參數。 ``` int QAbstractSlider.sliderPosition (self) ``` ``` QAbstractSlider.timerEvent (self, QTimerEvent) ``` 從重新實現[QObject.timerEvent](qobject.html#timerEvent)（）。 ``` QAbstractSlider.triggerAction (self, SliderAction?action) ``` 觸發一個滑塊_action_。可能的操作是[SliderSingleStepAdd](qabstractslider.html#SliderAction-enum)，[SliderSingleStepSub](qabstractslider.html#SliderAction-enum)，[SliderPageStepAdd](qabstractslider.html#SliderAction-enum)，[SliderPageStepSub](qabstractslider.html#SliderAction-enum)，[SliderToMinimum](qabstractslider.html#SliderAction-enum)，[SliderToMaximum](qabstractslider.html#SliderAction-enum)和[SliderMove](qabstractslider.html#SliderAction-enum)。 **See also** [actionTriggered](qabstractslider.html#actionTriggered)（）。 ``` int QAbstractSlider.value (self) ``` ``` QAbstractSlider.wheelEvent (self, QWheelEvent?e) ``` 從重新實現[QWidget.wheelEvent](qwidget.html#wheelEvent)（）。 * * * ## Qt Signal Documentation ``` void actionTriggered (int) ``` 這是該信號的默認超載。這個信號被發射時，在滑塊動作_action_被觸發。行動[SliderSingleStepAdd](qabstractslider.html#SliderAction-enum)，[SliderSingleStepSub](qabstractslider.html#SliderAction-enum)，[SliderPageStepAdd](qabstractslider.html#SliderAction-enum)，[SliderPageStepSub](qabstractslider.html#SliderAction-enum)，[SliderToMinimum](qabstractslider.html#SliderAction-enum)，[SliderToMaximum](qabstractslider.html#SliderAction-enum)和[SliderMove](qabstractslider.html#SliderAction-enum)。當信號被發射時，[sliderPosition](qabstractslider.html#sliderPosition-prop)根據動作進行了調整，但[value](qabstractslider.html#value-prop)尚未被傳播（意味著[valueChanged](qabstractslider.html#valueChanged)（）信號還沒有發出），并目測顯示未被更新。在連接到該信號插槽，你可以這樣放心地通過調用調整任何行動[setSliderPosition](qabstractslider.html#sliderPosition-prop)（）自己的基礎上，雙方的動作和滑塊的值。 **See also** [triggerAction](qabstractslider.html#triggerAction)（）。 ``` void rangeChanged (int,int) ``` 這是該信號的默認超載。這個信號被發射時的滑塊范圍發生了變化，與_min_作為新的最小值，并_max_作為新的最大值。 **See also** [minimum](qabstractslider.html#minimum-prop)和[maximum](qabstractslider.html#maximum-prop)。 ``` void sliderMoved (int) ``` 這是該信號的默認超載。這個信號被發射時[sliderDown](qabstractslider.html#sliderDown-prop)是真實的滑塊移動。這通常發生在用戶拖動滑塊發生。該_value_是新的滑塊位置。即使當跟蹤被關閉，這個信號被發射。 **See also** [setTracking](qabstractslider.html#tracking-prop)（）[valueChanged](qabstractslider.html#valueChanged)（）[isSliderDown](qabstractslider.html#sliderDown-prop)（）[sliderPressed](qabstractslider.html#sliderPressed)（）和[sliderReleased](qabstractslider.html#sliderReleased)（）。 ``` void sliderPressed () ``` 這是該信號的默認超載。當用戶按下滑塊用鼠標或編程時setSliderDown （真）被調用，這個信號被發射。 **See also** [sliderReleased](qabstractslider.html#sliderReleased)（）[sliderMoved](qabstractslider.html#sliderMoved)（）和[isSliderDown](qabstractslider.html#sliderDown-prop)（）。 ``` void sliderReleased () ``` 這是該信號的默認超載。當用戶釋放鼠標滑桿，或編程時setSliderDown （假）被稱為這個信號被發射。 **See also** [sliderPressed](qabstractslider.html#sliderPressed)（）[sliderMoved](qabstractslider.html#sliderMoved)（）和[sliderDown](qabstractslider.html#sliderDown-prop)。 ``` void valueChanged (int) ``` 這是該信號的默認超載。這個信號被發射時，滑塊值發生了變化，與新的滑塊_value_作為參數。