- 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方法
定义
singleStep()
定义
value()
虚函数#
槽(Slots)#
定义
setRange()
定义
setValue()
信号(Signals)#
注意
此文档可能包含自动从C++转换为Python的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题,也可以通过创建https:/bugreports.qt.io/projects/PYSIDE上的工单来告知我们。
详细描述#
该类被设计为类似
QScrollBar
、QSlider
和QDial
等小部件的通用超类。以下是该类的主要属性
value
:QAbstractSlider
维护的有界整数。minimum
: 最低可能值。maximum
: 最高可能值。singleStep
: 抽象滑块提供的两个自然步骤中的较小者,通常对应于用户按箭头键。pageStep
: 抽象滑块提供的两个自然步骤中的较大者,通常对应于用户按下 PageUp 或 PageDown。tracking
: 是否启用滑块跟踪。sliderPosition
: 滑块当前的当前位置。如果tracking
启用(默认值),则此值与value
相同。
(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,则最小值和最大值将出现在其相反位置。注意:此属性对于滑块和拨号器最有意义。对于滚动条,滚动条子控件的视觉效果取决于样式是否理解反转外观;大多数样式对于滚动条忽略此属性。
- 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ᅟ: int#
该属性保存单步。
这是抽象滑动条提供的两个自然步长中较小者,通常对应于用户按箭头键。
如果在自动重复按键事件期间修改此属性,行为是未定义的。
另请参阅
- 属性 sliderDownᅟ: bool#
该属性保存滑动条是否被按下。
子类设置此属性,以便让抽象滑动条知道跟踪是否有任何效果。
调整滑块的向下属性会发出
sliderPressed()
和sliderReleased()
信号。- 属性 sliderPosition: int#
此属性保存当前的滑块位置。
如果启用
tracking
(默认选项),则此值与value
相同。- 属性 tracking: bool#
此属性保存是否启用滑块跟踪。
如果启用跟踪(默认选项),则当拖动滑块时,滑块会发出
valueChanged()
信号。如果禁用跟踪,则会仅在用户释放滑块时发出valueChanged()
信号。另请参阅
sliderDown
- 属性 value: int#
此属性保存滑块的当前值。
滑块强制值处于法定范围内:
minimum
<=value
<=maximum
.更改值也会更改
sliderPosition
.- 访问函数
构建一个抽象滑块。
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()
来根据动作和滑动条值自行调整任何动作。另请参阅
- hasTracking()#
- 返回类型:bool
属性
tracking
的获取器。- invertedAppearance()#
- 返回类型:bool
属性
invertedAppearance
的获取器。- invertedControls()#
- 返回类型:bool
属性
invertedControls
的获取器。- isSliderDown()#
- 返回类型:bool
属性
sliderDown
的获取器。- maximum()#
- 返回类型:bool
int
另请参阅
属性
maximum
的获取器。- minimum()#
- 返回类型:bool
int
另请参阅
属性
minimum
的获取器。- orientation()#
- 返回类型:bool
另请参阅
属性
orientation
的获取器。- pageStep()#
- 返回类型:bool
int
另请参阅
属性
pageStep
的获取器。- rangeChanged(min, max)#
- 参数:
min – int
max – int
当滑动条的取值范围发生改变时发出此信号,其中
min
为新的最小值,而max
为新的最大值。- repeatAction()#
- 返回类型:bool
返回当前的重复动作。
另请参阅
- setInvertedAppearance(arg__1)#
- 参数:
arg__1 – bool
另请参阅
属性
invertedAppearance
的设置器。- setInvertedControls(arg__1)#
- 参数:
arg__1 – bool
另请参阅
属性
invertedControls
的设置器。属性
maximum
的设置器。属性
minimum
的设置器。- setOrientation(arg__1)#
- 参数:
arg__1 –
Orientation
另请参阅
属性
orientation
的设置器。- setPageStep(arg__1)#
- 参数:
arg__1 – int
另请参阅
属性
pageStep
的设置器。- setRange(min, max)#
- 参数:
min – int
max – int
将滑动条的最小值设置为
min
并且最大值设置为max
。如果
max
小于min
,则min
变为唯一合法的值。- setRepeatAction(action[, thresholdTime=500[, repeatTime=50]])#
- 参数:
action –
SliderAction
thresholdTime – int
repeatTime – int
将操作
action
设置为在间隔repeatTime
内重复触发,初始延迟为thresholdTime
。- setSingleStep(arg__1)#
- 参数:
arg__1 – int
另请参阅
属性
singleStep
的设置器。- setSliderDown(arg__1)#
- 参数:
arg__1 – bool
另请参阅
属性
sliderDown
的设置器。- setSliderPosition(arg__1)#
- 参数:
arg__1 – int
另请参阅
属性
sliderPosition
的设置器。- setTracking(enable)#
- 参数:
enable – bool
另请参阅
属性
tracking
的设置器。属性
value
的设置器。- singleStep()#
- 返回类型:bool
int
另请参阅
属性
singleStep
的获取器。- sliderChange(change)#
- 参数:
change –
SliderChange
重新实现此虚函数以跟踪滑块变化,例如
SliderRangeChange
,SliderOrientationChange
,SliderStepsChange
或SliderValueChange
。默认实现仅更新显示并忽略代码“change”参数。- sliderMoved(position)#
- 参数:
position – int
当
sliderDown
为 true 且滑块移动时,会发射此信号。通常当用户拖动滑块时发生。新的滑块位置是value
。即使禁用跟踪时也会发射此信号。
属性
sliderPosition
的通知信号。- sliderPosition()#
- 返回类型:bool
int
另请参阅
属性
sliderPosition
的获取器。- sliderPressed()#
当用户用鼠标按下滑块,或当程序调用
setSliderDown
(true) 时,会发射此信号。- sliderReleased()#
当用户释放滑块或通过调用
setSliderDown
(false) 时,将发射此信号。另请参阅
sliderPressed()
sliderMoved()
sliderDown
- triggerAction(action)#
- 参数:
action –
SliderAction
触发滑块的
action
。可能的操作包括SliderSingleStepAdd
,SliderSingleStepSub
,SliderPageStepAdd
,SliderPageStepSub
,SliderToMinimum
,SliderToMaximum
和SliderMove
。另请参阅
- value()#
- 返回类型:bool
int
另请参阅
是属性
valueᅟ
的获取器。- valueChanged(value)#
- 参数:
value – int
当滑块的值发生变化时,将发射此信号,其中包含新的滑块值
value
作为参数。属性
valueᅟ
的通知信号。