PySide6.QtWidgets.QAbstractSlider

class QAbstractSlider

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

PySide6.QtWidgets.QAbstractSlider 的继承图

继承自: QSlider, QScrollBar, QDial

概要

属性

方法

虚拟方法

插槽

信号

注意

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

详细描述

该类被设计为像QScrollBarQSliderQDial这样的小部件的通用超类。

以下是该类的主要属性:

  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:
property invertedControlsᅟ: bool

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

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

Access functions:
property maximumᅟ: int

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

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

Access functions:
property minimumᅟ: int

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

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

Access functions:
property orientationᅟ: Qt.Orientation

此属性保存滑块的朝向。

方向必须是 Qt::Vertical(默认)或 Qt::Horizontal。

Access functions:
property pageStepᅟ: int

此属性保存页面步长。

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

另请参阅

singleStep

Access functions:
property singleStepᅟ: int

此属性保存单步值。

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

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

另请参阅

pageStep

Access functions:
property sliderDownᅟ: bool

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

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

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

Access functions:
property sliderPositionᅟ: int

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

如果启用了tracking(默认情况下),这与value相同。

Access functions:
property trackingᅟ: bool

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

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

另请参阅

sliderDown

Access functions:
property valueᅟ: int

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

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

改变值也会改变sliderPosition

Access functions:
__init__([parent=None])
Parameters:

父级QWidget

构建一个抽象滑块。

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

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

actionTriggered(action)
Parameters:

action – 整数

当滑块动作 action 被触发时,会发出此信号。动作包括 SliderSingleStepAddSliderSingleStepSubSliderPageStepAddSliderPageStepSubSliderToMinimumSliderToMaximumSliderMove

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

另请参阅

triggerAction()

hasTracking()
Return type:

布尔

属性 trackingᅟ 的获取器。

invertedAppearance()
Return type:

布尔

属性 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__1Orientation

另请参阅

orientation()

属性 orientationᅟ 的设置器。

setPageStep(arg__1)
Parameters:

arg__1 – 整数

另请参阅

pageStep()

属性 pageStepᅟ 的设置器。

setRange(min, max)
Parameters:
  • min – int

  • max – int

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

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

另请参阅

minimum maximum

setRepeatAction(action[, thresholdTime=500[, repeatTime=50]])
Parameters:
  • actionSliderAction

  • thresholdTime – int

  • repeatTime – int

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

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

重新实现此虚拟函数以跟踪滑块更改,例如SliderRangeChangeSliderOrientationChangeSliderStepsChangeSliderValueChange。默认实现仅更新显示并忽略change参数。

sliderMoved(position)
Parameters:

position – int

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

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

属性 sliderPositionᅟ 的通知信号。

sliderPosition()
Return type:

整数

另请参阅

setSliderPosition()

属性 sliderPositionᅟ 的获取器。

sliderPressed()

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

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ᅟ 的通知信号。