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
isSliderDown()
def
maximum()
def
minimum()
def
orientation()
def
pageStep()
def
repeatAction()
def
setMaximum()
def
setMinimum()
def
setPageStep()
def
setSingleStep()
def
setSliderDown()
def
setTracking()
def
singleStep()
def
sliderPosition()
def
triggerAction()
def
value()
虚拟方法¶
def
sliderChange()
插槽¶
def
setOrientation()
def
setRange()
def
setValue()
信号¶
def
rangeChanged()
def
sliderMoved()
def
sliderPressed()
def
sliderReleased()
def
valueChanged()
注意
本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。
详细描述¶
该类被设计为像
QScrollBar
、QSlider
和QDial
这样的小部件的通用超类。以下是该类的主要属性:
value
:QAbstractSlider
维护的有界整数。minimum
: 可能的最低值。maximum
: 可能的最大值。singleStep
: 抽象滑块提供的两个自然步长中较小的一个,通常对应于用户按下箭头键。pageStep
: 抽象滑块提供的两个自然步骤中较大的一个,通常对应于用户按下PageUp或PageDown。tracking
: 是否启用滑块跟踪。sliderPosition
: 滑块的当前位置。如果启用了tracking
(默认情况下),这与value
相同。
Unity (1) 可以被视为第三个步长。
setValue()
允许你将当前值设置为允许范围内的任何整数,而不仅仅是minimum()
+ n *singleStep()
对于整数 n。一些部件可能允许用户设置任何值;其他部件可能只提供singleStep()
或pageStep()
的倍数。QAbstractSlider
发出一组全面的信号:信号
触发时机
值已更改。
tracking
决定了在用户交互期间是否发出此信号。用户开始拖动滑块。
用户拖动滑块。
用户释放滑块。
滑块动作被触发。
范围已更改。
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,最小值和最大值将出现在它们相反的位置。注意:此属性对于滑块和刻度盘最有意义。对于滚动条,滚动条子控件的视觉效果取决于样式是否理解反转外观;大多数样式对于滚动条忽略此属性。
- 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。
另请参阅
- Access functions:
- property singleStepᅟ: int¶
此属性保存单步值。
抽象滑块提供的两个自然步骤中较小的一个,通常对应于用户按下箭头键。
如果在自动重复按键事件期间修改了属性,行为是未定义的。
另请参阅
- 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:
构建一个抽象滑块。
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()
来调整任何操作。另请参阅
- hasTracking()¶
- Return type:
布尔
属性
trackingᅟ
的获取器。- invertedAppearance()¶
- Return type:
布尔
属性
invertedAppearanceᅟ
的获取器。- invertedControls()¶
- Return type:
布尔
属性
invertedControlsᅟ
的获取器。- isSliderDown()¶
- Return type:
布尔
属性
sliderDownᅟ
的获取器。- maximum()¶
- Return type:
整数
另请参阅
属性
maximumᅟ
的获取器。- minimum()¶
- Return type:
整数
另请参阅
属性
minimumᅟ
的获取器。- orientation()¶
- Return type:
另请参阅
属性
orientationᅟ
的获取器。- pageStep()¶
- Return type:
整数
另请参阅
属性
pageStepᅟ
的获取器。- rangeChanged(min, max)¶
- Parameters:
min – int
max – int
当滑块范围发生变化时,会发出此信号,其中
min
为新的最小值,max
为新的最大值。- repeatAction()¶
- Return type:
返回当前的重复操作。
另请参阅
- setInvertedAppearance(arg__1)¶
- Parameters:
arg__1 – 布尔值
另请参阅
属性
invertedAppearanceᅟ
的设置器。- setInvertedControls(arg__1)¶
- Parameters:
arg__1 – 布尔值
另请参阅
属性
invertedControlsᅟ
的设置器。属性
maximumᅟ
的设置器。属性
minimumᅟ
的设置器。- setOrientation(arg__1)¶
- Parameters:
arg__1 –
Orientation
另请参阅
属性
orientationᅟ
的设置器。- setPageStep(arg__1)¶
- Parameters:
arg__1 – 整数
另请参阅
属性
pageStepᅟ
的设置器。- setRange(min, max)¶
- Parameters:
min – int
max – int
将滑块的最小值设置为
min
,最大值设置为max
。如果
max
小于min
,min
将成为唯一合法的值。- setRepeatAction(action[, thresholdTime=500[, repeatTime=50]])¶
- Parameters:
action –
SliderAction
thresholdTime – int
repeatTime – int
设置动作
action
在初始延迟thresholdTime
后,以repeatTime
的间隔重复触发。- setSingleStep(arg__1)¶
- Parameters:
arg__1 – 整数
另请参阅
属性
singleStepᅟ
的设置器。- setSliderDown(arg__1)¶
- Parameters:
arg__1 – 布尔值
另请参阅
属性
sliderDownᅟ
的设置器。- setSliderPosition(arg__1)¶
- Parameters:
arg__1 – 整数
另请参阅
属性
sliderPositionᅟ
的设置器。- setTracking(enable)¶
- Parameters:
enable – 布尔值
另请参阅
属性
trackingᅟ
的设置器。属性
valueᅟ
的设置器。- singleStep()¶
- Return type:
整数
另请参阅
属性
singleStepᅟ
的获取器。- sliderChange(change)¶
- Parameters:
变化 –
SliderChange
重新实现此虚拟函数以跟踪滑块更改,例如
SliderRangeChange
、SliderOrientationChange
、SliderStepsChange
或SliderValueChange
。默认实现仅更新显示并忽略change
参数。- sliderMoved(position)¶
- Parameters:
position – int
当
sliderDown
为真且滑块移动时,会发出此信号。这通常发生在用户拖动滑块时。value
是滑块的新位置。即使跟踪关闭,也会发出此信号。
属性
sliderPositionᅟ
的通知信号。- sliderPosition()¶
- Return type:
整数
另请参阅
属性
sliderPositionᅟ
的获取器。- sliderPressed()¶
当用户用鼠标按下滑块时,或者当调用
setSliderDown
(true) 时,会发出此信号。- sliderReleased()¶
当用户用鼠标释放滑块时,或者当调用
setSliderDown
(false) 时,会发出此信号。另请参阅
sliderPressed()
sliderMoved()
sliderDown
- triggerAction(action)¶
- Parameters:
动作 –
SliderAction
触发一个滑块
action
。可能的操作是SliderSingleStepAdd
,SliderSingleStepSub
,SliderPageStepAdd
,SliderPageStepSub
,SliderToMinimum
,SliderToMaximum
, 和SliderMove
。另请参阅
- value()¶
- Return type:
整数
另请参阅
属性
valueᅟ
的获取器。- valueChanged(value)¶
- Parameters:
值 – int
当滑块值发生变化时,会发出此信号,新的滑块
value
作为参数。属性
valueᅟ
的通知信号。