滚动条基类QAbstractSlider
QAbstractSlider类提供一个范围内的整数值
QAbstractSlider子类包括QSlider, QScrollBar, QDial
from PySide6.QtWidgets import QAbstractSlider
QAbstractSlider(self, parent: Union[PySide6.QtWidgets.QWidget, NoneType] = None)
构造一个抽象滑块。
父参数被发送到QWidget构造函数。
最小值默认为0,最大值为99,单步大小为1,pageStep大小为10,初始值为0。
QAbstractSlider官方描述
该类被设计为QScrollBar,QSlider和QDial等小部件的通用超类。
以下是类的主要属性:
- value: QAbstractSlider维护的有界整数。
- minimum: 可能的最低值。
- maximum: 可能的最高值。
- singleStep: 抽象滑块提供的两个自然步骤中较小的一个,通常对应于用户按下箭头键。
- pageStep: 抽象滑块提供的两个自然步骤中的较大者,通常对应于用户按PageUp或PageDown。
- tracking: 是否启用滑块跟踪。
- sliderPosition: 滑块的当前位置。如果启用了跟踪 (默认),则此值与值相同。
Unity (1) 可以被视为第三步长。setValue() 允许您将当前值设置为允许范围内的任何整数,而不仅仅是n的整数值的minimum() n * singleStep()。一些小部件可能允许用户设置任何值; 其他人可能只是提供singleStep() 或pageStep() 的倍数。
QAbstractSlider发出一组全面的信号:
Signal | Emitted when |
---|---|
valueChanged() | 值已更改。跟踪确定在用户交互期间是否发出此信号。 |
sliderPressed() | 用户开始拖动滑块。 |
sliderMoved() | 用户拖动滑块。 |
sliderReleased() | 用户释放滑块。 |
actionTriggered() | 触发了滑块操作。 |
rangeChanged() | 范围已更改。 |
QAbstractSlider提供了一个虚拟sliderChange() 函数,非常适合更新滑块的屏幕表示。通过调用triggerAction(),子类触发滑块动作。两个帮助函数sliderPositionFromValue() 和sliderValueFromPosition() 帮助子类和样式将屏幕坐标映射到逻辑范围值。
QAbstractSlider属性
属性 | 描述 | 功能访问 |
---|---|---|
invertedAppearance: bool | 此属性是否保留滑块显示其值反转。 如果此属性为false (默认),则最小值和最大值将显示在继承的小部件的经典位置。如果该值为true,则最小值和最大值出现在它们的相反位置。 注意: 此属性对于滑块和拨盘最有意义。对于滚动条,滚动条子控件的视觉效果取决于样式是否理解倒转外观。大多数样式都忽略了滚动条的此属性。 | invertedAppearance () setInvertedAppearance (arg__1) |
invertedControls: bool | 这个属性是否持有滑块反转它的车轮和关键事件。 如果此属性为false,则将鼠标滚轮 “向上” 滚动并使用诸如page up之类的键将使滑块的值向其最大值增加。否则,向上按page将使值向滑块的最小值移动。 | invertedControls () setInvertedControls (arg__1) |
maximum: int | 此属性保存滑块的最大值。 设置此属性时,如有必要,将调整最小值,以确保范围保持有效。滑块的当前值也被调整到新范围内。 | maximum () setMaximum (arg__1) |
minimum: int | 此属性保留滑块的最小值。 设置此属性时,如有必要,会调整最大值,以确保范围保持有效。滑块的当前值也被调整到新范围内。 | minimum () setMinimum (arg__1) |
orientation: Orientation | 此属性保存滑块的方向。 方向必须是垂直 (默认) 或水平。 | orientation () setOrientation (arg__1) |
pageStep: int | 此属性保留页面步骤 … 抽象滑块提供的两个自然步骤中的较大者,通常对应于用户按PageUp或PageDown。 | pageStep () setPageStep (arg__1) |
singleStep: int | 此属性持有单步。 抽象滑块提供的两个自然步骤中的较小者,通常对应于用户按下箭头键。 如果在自动重复键事件期间修改了属性,则行为未定义。 | singleStep () setSingleStep (arg__1) |
sliderDown: bool | 此属性保留是否按下滑块 … 该属性由子类设置,以便让抽象滑块知道跟踪是否有任何效果。 更改slider down属性会发出sliderPressed() 和slider释放 () 信号。 | isSliderDown () setSliderDown (arg__1) |
sliderPosition: int | 此属性保持当前滑块位置。 如果启用了跟踪 (默认),则此值与值相同。 | sliderPosition () setSliderPosition (arg__1) Signal sliderMoved (position) |
tracking: bool | 此属性保存是否启用滑块跟踪。 如果启用了跟踪 (默认),则滑块在拖动滑块时会发出valueanged () 信号。如果禁用跟踪,则仅当用户释放滑块时,滑块才会发出valueanged () 信号。 | hasTracking () setTracking (enable) |
value: int | 此属性保存滑块的当前值。 滑块强制该值在法定范围内: 最小值 <= 值 <= 最大值。 更改值也会更改滑块位置。 | value () setValue (arg__1) Signal valueChanged (value) |
QAbstractSlider方法
-
PySide6.QtWidgets.QAbstractSlider.SliderAction
Constant Description QAbstractSlider.SliderNoAction QAbstractSlider.SliderSingleStepAdd QAbstractSlider.SliderSingleStepSub QAbstractSlider.SliderPageStepAdd QAbstractSlider.SliderPageStepSub QAbstractSlider.SliderToMinimum QAbstractSlider.SliderToMaximum QAbstractSlider.SliderMove -
PySide6.QtWidgets.QAbstractSlider.SliderChange
Constant Description QAbstractSlider.SliderRangeChange QAbstractSlider.SliderOrientationChange QAbstractSlider.SliderStepsChange QAbstractSlider.SliderValueChange
方法 | 描述 |
---|---|
hasTracking() -> bool | tracking属性获取 |
invertedAppearance() -> bool | invertedAppearance属性获取 |
invertedControls() -> bool | invertedControls属性获取 |
isSliderDown() -> bool | sliderDown属性获取 |
maximum() -> int | maximum属性获取 |
minimum() -> int | minimum属性获取 |
orientation() -> PySide6.QtCore.Qt.Orientation | orientation属性获取 |
pageStep() -> int | pageStep属性获取 |
singleStep() -> int | singleStep属性获取 |
sliderPosition() -> int | sliderPosition属性获取 |
value() -> int | value属性获取 |
[Slot]setValue(arg__1: int) | 设置属性value |
setInvertedAppearance(arg__1: bool) | 设置属性invertedAppearance |
setInvertedControls(arg__1: bool) | 设置属性invertedControls |
setMaximum(arg__1: int) | 设置属性maximum |
setMinimum(arg__1: int) | 设置属性minimum |
setPageStep(arg__1: int) | 设置属性pageStep |
setRepeatAction(action: PySide6.QtWidgets.QAbstractSlider.SliderAction, thresholdTime: int = 500, repeatTime: int = 50) | 将动作动作设置为在阈值的初始延迟之后,在重复时间的间隔内重复触发。 |
setSingleStep(arg__1: int) | 设置属性singleStep |
setSliderDown(arg__1: bool) | 设置属性sliderDown |
setSliderPosition(arg__1: int) | 设置属性sliderPosition |
setTracking(enable: bool) | 设置属性tracking |
[Slot]setOrientation(arg__1: PySide6.QtCore.Qt.Orientation) | 设置属性orientation |
repeatAction() -> PySide6.QtWidgets.QAbstractSlider.SliderAction | 返回当前的重复操作。 |
triggerAction(action: PySide6.QtWidgets.QAbstractSlider.SliderAction) | 触发滑块动作。可能的动作有SliderSingleStepAdd、SliderSingleStepSub、SliderPageStepAdd、SliderPageStepSub、slidertoiminum、slidertommimum和SliderMove。 |
sliderChange(change: PySide6.QtWidgets.QAbstractSlider.SliderChange) | 重新实现此虚拟函数以跟踪滑块更改,例如SliderRangeChange,SliderOrientationChange,SliderStepsChange或SliderValueChange。默认实现仅更新显示,而忽略更改参数。 |
[Slot]setRange(min: int, max: int) | 将滑块的最小值设置为最小,将其最大值设置为最大。如果max小于min,则min成为唯一的法定值。 |
QAbstractSlider信号
方法 | 描述 |
---|---|
actionTriggered(action:int) | 此信号在滑块动作动作被触发时发出。动作有SliderSingleStepAdd、SliderSingleStepSub、SliderPageStepAdd、SliderPageStepSub、slidertoiminum、slidertommimum和SliderMove。 当信号发出时,滑块位置已经根据动作进行了调整,但是值尚未传播 (意味着值更改 () 信号尚未发出),并且视觉显示尚未更新。因此,在连接到此信号的插槽中,您可以根据操作和滑块的值自行调用setSliderPosition() 来安全地调整任何操作。 |
rangeChanged(min:int, max:int) | 当滑块范围发生变化时,将发出此信号,其中min是新的最小值,而max是新的最大值。 |
sliderMoved(position:int) | 当sliderDown为真并且滑块移动时,会发出此信号。这通常发生在用户拖动滑块时。该值是新的滑块位置。 即使关闭跟踪,该信号也会发出。 |
sliderPressed() | 当用户用鼠标按下滑块时,或者当调用setSliderDown (true) 时,以编程方式发出此信号。 |
sliderReleased() | 当用户用鼠标释放滑块时,或者当调用setSliderDown (false) 时,以编程方式发出此信号。 |
valueChanged(value:int) | 当滑块值发生变化时,将以新的滑块值作为参数,发出此信号。 属性值的通知信号。 |