class QAbstractSlider#

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

Inheritance diagram of PySide6.QtWidgets.QAbstractSlider

继承自: QSliderQScrollBarQDial

摘要#

属性#

方法#

虚函数#

槽(Slots)#

信号(Signals)#

注意

此文档可能包含自动从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 相同。

(1)可被视为第三种步骤大小。 setValue() 允许您将当前值设置为允许范围内的任何整数,而不仅仅是 minimum() + n * singleStep() 中的整数 n。一些小部件可能允许用户设置任何值;其他小部件可能仅提供 singleStep()pageStep() 的倍数。

QAbstractSlider 发射一组完整的信号

信号

在发出时

valueChanged()

值已更改。 tracking 决定是否在用户交互期间发出此信号。

sliderPressed()

用户开始拖动滑块。

sliderMoved()

用户拖动滑块。

sliderReleased()

用户释放滑块。

actionTriggered()

触发了一个滑块操作。

rangeChanged()

范围已更改。

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

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,则最小值和最大值将出现在其相反位置。

注意:此属性对于滑块和拨号器最有意义。对于滚动条,滚动条子控件的视觉效果取决于样式是否理解反转外观;大多数样式对于滚动条忽略此属性。

访问函数
property invertedControlsᅟ: bool#

该属性表示滑块是否反转其鼠标滚轮和键盘事件。

如果此属性为false,则使用鼠标滚轮“向上滚动”和“page up”等键会增加滑动条值向最大值方向。否则,按“page up”键将使值向滑动条的最小值方向移动。

访问函数
属性 maximumᅟ: int#

该属性保存滑动条的最大值。

设置此属性时,如果需要,将调整minimum,以确保范围保持有效。此外,滑动条当前值也会根据新的范围进行调整。

访问函数
属性 minimumᅟ: int#

该属性保存滑动条的最小值。

设置此属性时,如果需要,将调整maximum,以确保范围保持有效。此外,滑动条当前值也会根据新的范围进行调整。

访问函数
属性 orientationᅟ: Qt.Orientation#

该属性保存滑动条的方向。

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

访问函数
属性 pageStepᅟ: int#

该属性保存页面步长。

这是抽象滑动条提供的两个自然步长中较大者,通常对应于用户按“PageUp”或“PageDown”的组合键。

另请参阅

singleStep

访问函数
属性 singleStepᅟ: int#

该属性保存单步。

这是抽象滑动条提供的两个自然步长中较小者,通常对应于用户按箭头键。

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

另请参阅

pageStep

访问函数
属性 sliderDownᅟ: bool#

该属性保存滑动条是否被按下。

子类设置此属性,以便让抽象滑动条知道跟踪是否有任何效果。

调整滑块的向下属性会发出 sliderPressed()sliderReleased() 信号。

访问函数
属性 sliderPosition: int#

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

如果启用 tracking(默认选项),则此值与 value 相同。

访问函数
属性 tracking: bool#

此属性保存是否启用滑块跟踪。

如果启用跟踪(默认选项),则当拖动滑块时,滑块会发出 valueChanged() 信号。如果禁用跟踪,则会仅在用户释放滑块时发出 valueChanged() 信号。

另请参阅

sliderDown

访问函数
属性 value: int#

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

滑块强制值处于法定范围内: minimum <= value <= maximum .

更改值也会更改 sliderPosition .

访问函数
__init__([parent=None])#
参数:

parentQWidget

构建一个抽象滑块。

parent 参数传递给 QWidget 构造函数。

默认情况下,minimum 为0,maximum 为99,步长为1,页面增量为10,初始值默认为0。

actionTriggered(action)#
参数:

action – int

当滑动条动作 action 被触发时,会发出此信号。动作可包括 SliderSingleStepAdd (单步增加),SliderSingleStepSub (单步减少),SliderPageStepAdd (页面增加),SliderPageStepSub (页面减少),SliderToMinimum (移动到最小值),SliderToMaximum (移动到最大值)以及 SliderMove (移动动作)。

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

另请参阅

triggerAction()

hasTracking()#
返回类型:bool

属性 tracking 的获取器。

invertedAppearance()#
返回类型:bool

属性 invertedAppearance 的获取器。

invertedControls()#
返回类型:bool

另请参阅

setInvertedControls()

属性 invertedControls 的获取器。

isSliderDown()#
返回类型:bool

属性 sliderDown 的获取器。

maximum()#
返回类型:bool

int

另请参阅

setMaximum()

属性 maximum 的获取器。

minimum()#
返回类型:bool

int

另请参阅

setMinimum()

属性 minimum 的获取器。

orientation()#
返回类型:bool

Orientation

另请参阅

setOrientation()

属性 orientation 的获取器。

pageStep()#
返回类型:bool

int

另请参阅

setPageStep()

属性 pageStep 的获取器。

rangeChanged(min, max)#
参数:
  • min – int

  • max – int

当滑动条的取值范围发生改变时发出此信号,其中 min 为新的最小值,而 max 为新的最大值。

另请参阅

minimum maximum

repeatAction()#
返回类型:bool

SliderAction

返回当前的重复动作。

另请参阅

setRepeatAction()

setInvertedAppearance(arg__1)#
参数:

arg__1 – bool

另请参阅

invertedAppearance()

属性 invertedAppearance 的设置器。

setInvertedControls(arg__1)#
参数:

arg__1 – bool

另请参阅

invertedControls()

属性 invertedControls 的设置器。

setMaximum(arg__1)#
参数:

arg__1 – int

另请参阅

maximum()

属性 maximum 的设置器。

setMinimum(arg__1)#
参数:

arg__1 – int

另请参阅

minimum()

属性 minimum 的设置器。

setOrientation(arg__1)#
参数:

arg__1Orientation

另请参阅

orientation()

属性 orientation 的设置器。

setPageStep(arg__1)#
参数:

arg__1 – int

另请参阅

pageStep()

属性 pageStep 的设置器。

setRange(min, max)#
参数:
  • min – int

  • max – int

将滑动条的最小值设置为 min 并且最大值设置为 max

如果 max 小于 min,则 min 变为唯一合法的值。

另请参阅

minimum maximum

setRepeatAction(action[, thresholdTime=500[, repeatTime=50]])#
参数:
  • actionSliderAction

  • thresholdTime – int

  • repeatTime – int

将操作 action 设置为在间隔 repeatTime 内重复触发,初始延迟为 thresholdTime

setSingleStep(arg__1)#
参数:

arg__1 – int

另请参阅

singleStep()

属性 singleStep 的设置器。

setSliderDown(arg__1)#
参数:

arg__1 – bool

另请参阅

isSliderDown()

属性 sliderDown 的设置器。

setSliderPosition(arg__1)#
参数:

arg__1 – int

另请参阅

sliderPosition()

属性 sliderPosition 的设置器。

setTracking(enable)#
参数:

enable – bool

另请参阅

hasTracking()

属性 tracking 的设置器。

setValue(arg__1)#
参数:

arg__1 – int

另请参阅

value()

属性 value 的设置器。

singleStep()#
返回类型:bool

int

另请参阅

setSingleStep()

属性 singleStep 的获取器。

sliderChange(change)#
参数:

changeSliderChange

重新实现此虚函数以跟踪滑块变化,例如 SliderRangeChangeSliderOrientationChangeSliderStepsChangeSliderValueChange 。默认实现仅更新显示并忽略代码“change”参数。

sliderMoved(position)#
参数:

position – int

sliderDown 为 true 且滑块移动时,会发射此信号。通常当用户拖动滑块时发生。新的滑块位置是 value

即使禁用跟踪时也会发射此信号。

属性 sliderPosition 的通知信号。

sliderPosition()#
返回类型:bool

int

另请参阅

setSliderPosition()

属性 sliderPosition 的获取器。

sliderPressed()#

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

sliderReleased()#

当用户释放滑块或通过调用 setSliderDown (false) 时,将发射此信号。

另请参阅

sliderPressed() sliderMoved() sliderDown

triggerAction(action)#
参数:

actionSliderAction

触发滑块的 action。可能的操作包括 SliderSingleStepAddSliderSingleStepSubSliderPageStepAddSliderPageStepSubSliderToMinimumSliderToMaximumSliderMove

另请参阅

actionTriggered()

value()#
返回类型:bool

int

另请参阅

setValue()

是属性 valueᅟ 的获取器。

valueChanged(value)#
参数:

value – int

当滑块的值发生变化时,将发射此信号,其中包含新的滑块值 value 作为参数。

属性 valueᅟ 的通知信号。