PySide6.QtWidgets.QAbstractSlider¶

class QAbstractSlider¶

QAbstractSlider 类提供了一个范围内的整数值。更多…

继承自： QSlider, QScrollBar, QDial

概要¶

属性¶

• invertedAppearanceᅟ - 滑块是否显示其反转值

• invertedControlsᅟ - 滑块是否反转其滚轮和按键事件

• maximumᅟ - 滑块的最大值

• minimumᅟ - 滑块的最小值

• orientationᅟ - 滑块的朝向

• pageStepᅟ - 页面步长

• singleStepᅟ - 单步

• sliderDownᅟ - 滑块是否被按下

• sliderPositionᅟ - 当前滑块位置

• trackingᅟ - 是否启用滑块跟踪

• valueᅟ - 滑块的当前值

方法¶

• def __init__()

• def hasTracking()

• def invertedAppearance()

• def invertedControls()

• def isSliderDown()

• def maximum()

• def minimum()

• def orientation()

• def pageStep()

• def repeatAction()

• def setInvertedAppearance()

• def setInvertedControls()

• def setMaximum()

• def setMinimum()

• def setPageStep()

• def setRepeatAction()

• def setSingleStep()

• def setSliderDown()

• def setSliderPosition()

• def setTracking()

• def singleStep()

• def sliderPosition()

• def triggerAction()

• def value()

虚拟方法¶

• def sliderChange()

插槽¶

• def setOrientation()

• def setRange()

• def setValue()

信号¶

• def actionTriggered()

• def rangeChanged()

• def sliderMoved()

• def sliderPressed()

• def sliderReleased()

• def valueChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

该类被设计为像QScrollBar、QSlider和QDial这样的小部件的通用超类。

以下是该类的主要属性：

1. value : QAbstractSlider 维护的有界整数。

2. minimum : 可能的最低值。

3. maximum : 可能的最大值。

4. singleStep : 抽象滑块提供的两个自然步长中较小的一个，通常对应于用户按下箭头键。

5. pageStep : 抽象滑块提供的两个自然步骤中较大的一个，通常对应于用户按下PageUp或PageDown。

6. tracking : 是否启用滑块跟踪。

7. sliderPosition : 滑块的当前位置。如果启用了tracking（默认情况下），这与value相同。

Unity (1) 可以被视为第三个步长。setValue() 允许你将当前值设置为允许范围内的任何整数，而不仅仅是 minimum() + n * singleStep() 对于整数 n。一些部件可能允许用户设置任何值；其他部件可能只提供 singleStep() 或 pageStep() 的倍数。

QAbstractSlider 发出一组全面的信号：

信号	触发时机
valueChanged()	值已更改。tracking 决定了在用户交互期间是否发出此信号。
sliderPressed()	用户开始拖动滑块。
sliderMoved()	用户拖动滑块。
sliderReleased()	用户释放滑块。
actionTriggered()	滑块动作被触发。
rangeChanged()	范围已更改。

QAbstractSlider 提供了一个虚拟的 sliderChange() 函数，非常适合更新滑块的屏幕表示。通过调用 triggerAction()，子类可以触发滑块操作。两个辅助函数 sliderPositionFromValue() 和 sliderValueFromPosition() 帮助子类和样式将屏幕坐标映射到逻辑范围值。

另请参阅

QAbstractSpinBox QSlider QDial QScrollBar 滑块示例

class SliderAction¶

常量	描述
QAbstractSlider.SliderNoAction
QAbstractSlider.SliderSingleStepAdd
QAbstractSlider.SliderSingleStepSub
QAbstractSlider.SliderPageStepAdd
QAbstractSlider.SliderPageStepSub
QAbstractSlider.SliderToMinimum
QAbstractSlider.SliderToMaximum
QAbstractSlider.SliderMove

class SliderChange¶

常量	描述
QAbstractSlider.SliderRangeChange
QAbstractSlider.SliderOrientationChange
QAbstractSlider.SliderStepsChange
QAbstractSlider.SliderValueChange

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property invertedAppearanceᅟ: bool¶

此属性控制滑块是否显示其反转值。

如果此属性为false（默认值），最小值和最大值将显示在继承的小部件的经典位置。如果值为true，最小值和最大值将出现在它们相反的位置。

注意：此属性对于滑块和刻度盘最有意义。对于滚动条，滚动条子控件的视觉效果取决于样式是否理解反转外观；大多数样式对于滚动条忽略此属性。

Access functions:

• invertedAppearance()

• setInvertedAppearance()

property invertedControlsᅟ: bool¶

此属性控制滑块是否反转其滚轮和按键事件。

如果此属性为false，向上滚动鼠标滚轮和使用向上翻页等键将增加滑块的值，使其接近最大值。否则，按下向上翻页键将使滑块的值接近最小值。

Access functions:

• invertedControls()

• setInvertedControls()

property maximumᅟ: int¶

此属性保存滑块的最大值。

设置此属性时，如有必要，minimum 会被调整以确保范围仍然有效。同时，滑块的当前值也会被调整以适应新的范围。

Access functions:

• maximum()

• setMaximum()

property minimumᅟ: int¶

此属性保存滑块的最小值。

设置此属性时，如有必要，将调整maximum以确保范围保持有效。同时，滑块的当前值也会被调整以适应新的范围。

Access functions:

• minimum()

• setMinimum()

property orientationᅟ: Qt.Orientation¶

此属性保存滑块的朝向。

方向必须是 Qt::Vertical（默认）或 Qt::Horizontal。

Access functions:

• orientation()

• setOrientation()

property pageStepᅟ: int¶

此属性保存页面步长。

抽象滑块提供的两个自然步骤中较大的一个，通常对应于用户按下PageUp或PageDown。

另请参阅

singleStep

Access functions:

• pageStep()

• setPageStep()

property singleStepᅟ: int¶

此属性保存单步值。

抽象滑块提供的两个自然步骤中较小的一个，通常对应于用户按下箭头键。

如果在自动重复按键事件期间修改了属性，行为是未定义的。

另请参阅

pageStep

Access functions:

• singleStep()

• setSingleStep()

property sliderDownᅟ: bool¶

此属性表示滑块是否被按下。

该属性由子类设置，以便让抽象滑块知道tracking是否有效。

向下移动滑块会发出 sliderPressed() 和 sliderReleased() 信号。

Access functions:

• isSliderDown()

• setSliderDown()

property sliderPositionᅟ: int¶

此属性保存当前的滑块位置。

如果启用了tracking（默认情况下），这与value相同。

Access functions:

• sliderPosition()

• setSliderPosition()

• 信号 sliderMoved()

property trackingᅟ: bool¶

此属性表示是否启用了滑块跟踪。

如果启用了跟踪（默认情况下），滑块在被拖动时会发出valueChanged()信号。如果禁用了跟踪，滑块仅在用户释放滑块时发出valueChanged()信号。

另请参阅

sliderDown

Access functions:

• hasTracking()

• setTracking()

property valueᅟ: int¶

此属性保存滑块的当前值。

滑块强制值在合法范围内：minimum <= value <= maximum 。

改变值也会改变sliderPosition。

Access functions:

• value()

• setValue()

• 信号 valueChanged()

__init__([parent=None])¶

Parameters:

父级 – QWidget

构建一个抽象滑块。

parent 参数被发送到 QWidget 构造函数。

minimum 默认值为 0，maximum 默认值为 99，singleStep 的大小为 1，pageStep 的大小为 10，初始 value 为 0。

actionTriggered(action)¶

Parameters:

action – 整数

当滑块动作 action 被触发时，会发出此信号。动作包括 SliderSingleStepAdd、SliderSingleStepSub、SliderPageStepAdd、SliderPageStepSub、SliderToMinimum、SliderToMaximum 和 SliderMove。

当信号发出时，sliderPosition 已根据操作进行了调整，但 value 尚未传播（意味着 valueChanged() 信号尚未发出），并且视觉显示尚未更新。因此，在连接到该信号的插槽中，您可以根据操作和滑块的值安全地调用 setSliderPosition() 来调整任何操作。

另请参阅

triggerAction()

hasTracking()¶

Return type:

布尔

属性 trackingᅟ 的获取器。

invertedAppearance()¶

Return type:

布尔

另请参阅

setInvertedAppearance()

属性 invertedAppearanceᅟ 的获取器。

invertedControls()¶

Return type:

布尔

另请参阅

setInvertedControls()

属性 invertedControlsᅟ 的获取器。

isSliderDown()¶

Return type:

布尔

属性 sliderDownᅟ 的获取器。

maximum()¶

Return type:

整数

另请参阅

setMaximum()

属性 maximumᅟ 的获取器。

minimum()¶

Return type:

整数

另请参阅

setMinimum()

属性 minimumᅟ 的获取器。

orientation()¶

Return type:

方向

另请参阅

setOrientation()

属性 orientationᅟ 的获取器。

pageStep()¶

Return type:

整数

另请参阅

setPageStep()

属性 pageStepᅟ 的获取器。

rangeChanged(min, max)¶

Parameters:

• min – int

• max – int

当滑块范围发生变化时，会发出此信号，其中min为新的最小值，max为新的最大值。

另请参阅

minimum maximum

repeatAction()¶

Return type:

SliderAction

返回当前的重复操作。

另请参阅

setRepeatAction()

setInvertedAppearance(arg__1)¶

Parameters:

arg__1 – 布尔值

另请参阅

invertedAppearance()

属性 invertedAppearanceᅟ 的设置器。

setInvertedControls(arg__1)¶

Parameters:

arg__1 – 布尔值

另请参阅

invertedControls()

属性 invertedControlsᅟ 的设置器。

setMaximum(arg__1)¶

Parameters:

arg__1 – 整数

另请参阅

maximum()

属性 maximumᅟ 的设置器。

setMinimum(arg__1)¶

Parameters:

arg__1 – 整数

另请参阅

minimum()

属性 minimumᅟ 的设置器。

setOrientation(arg__1)¶

Parameters:

arg__1 – Orientation

另请参阅

orientation()

属性 orientationᅟ 的设置器。

setPageStep(arg__1)¶

Parameters:

arg__1 – 整数

另请参阅

pageStep()

属性 pageStepᅟ 的设置器。

setRange(min, max)¶

Parameters:

• min – int

• max – int

将滑块的最小值设置为min，最大值设置为max。

如果 max 小于 min，min 将成为唯一合法的值。

另请参阅

minimum maximum

setRepeatAction(action[, thresholdTime=500[, repeatTime=50]])¶

Parameters:

• action – SliderAction

• thresholdTime – int

• repeatTime – int

设置动作 action 在初始延迟 thresholdTime 后，以 repeatTime 的间隔重复触发。

另请参阅

triggerAction() repeatAction()

setSingleStep(arg__1)¶

Parameters:

arg__1 – 整数

另请参阅

singleStep()

属性 singleStepᅟ 的设置器。

setSliderDown(arg__1)¶

Parameters:

arg__1 – 布尔值

另请参阅

isSliderDown()

属性 sliderDownᅟ 的设置器。

setSliderPosition(arg__1)¶

Parameters:

arg__1 – 整数

另请参阅

sliderPosition()

属性 sliderPositionᅟ 的设置器。

setTracking(enable)¶

Parameters:

enable – 布尔值

另请参阅

hasTracking()

属性 trackingᅟ 的设置器。

setValue(arg__1)¶

Parameters:

arg__1 – 整数

另请参阅

value()

属性 valueᅟ 的设置器。

singleStep()¶

Return type:

整数

另请参阅

setSingleStep()

属性 singleStepᅟ 的获取器。

sliderChange(change)¶

Parameters:

变化 – SliderChange

重新实现此虚拟函数以跟踪滑块更改，例如SliderRangeChange、SliderOrientationChange、SliderStepsChange或SliderValueChange。默认实现仅更新显示并忽略change参数。

sliderMoved(position)¶

Parameters:

position – int

当sliderDown为真且滑块移动时，会发出此信号。这通常发生在用户拖动滑块时。value是滑块的新位置。

即使跟踪关闭，也会发出此信号。

另请参阅

setTracking() valueChanged() isSliderDown() sliderPressed() sliderReleased()

属性 sliderPositionᅟ 的通知信号。

sliderPosition()¶

Return type:

整数

另请参阅

setSliderPosition()

属性 sliderPositionᅟ 的获取器。

sliderPressed()¶

当用户用鼠标按下滑块时，或者当调用setSliderDown (true) 时，会发出此信号。

另请参阅

sliderReleased() sliderMoved() isSliderDown()

sliderReleased()¶

当用户用鼠标释放滑块时，或者当调用setSliderDown (false) 时，会发出此信号。

另请参阅

sliderPressed() sliderMoved() sliderDown

triggerAction(action)¶

Parameters:

动作 – SliderAction

触发一个滑块 action。可能的操作是 SliderSingleStepAdd , SliderSingleStepSub , SliderPageStepAdd , SliderPageStepSub , SliderToMinimum , SliderToMaximum , 和 SliderMove 。

另请参阅

actionTriggered()

value()¶

Return type:

整数

另请参阅

setValue()

属性 valueᅟ 的获取器。

valueChanged(value)¶

Parameters:

值 – int

当滑块值发生变化时，会发出此信号，新的滑块value作为参数。

属性 valueᅟ 的通知信号。