PySide6.QtWidgets.QSlider¶

class QSlider¶

QSlider 小部件提供了一个垂直或水平的滑块。更多…

概要¶

属性¶

tickIntervalᅟ - 刻度标记之间的间隔
tickPositionᅟ - 此滑块的刻度位置

方法¶

def __init__()
def setTickInterval()
def setTickPosition()
def tickInterval()
def tickPosition()

虚拟方法¶

def initStyleOption()

注意

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

详细描述¶

滑块是用于控制有界值的经典小部件。它允许用户沿着水平或垂直凹槽移动滑块手柄，并将手柄的位置转换为合法范围内的整数值。

QSlider 本身的功能非常少；大部分功能都在 QAbstractSlider 中。最有用的函数是 setValue()，用于直接将滑块设置为某个值；triggerAction() 用于模拟点击效果（对快捷键很有用）；setSingleStep() 和 setPageStep() 用于设置步长；以及 setMinimum() 和 setMaximum() 用于定义滚动条的范围。

QSlider 提供了控制刻度标记的方法。你可以使用 setTickPosition() 来指定你希望刻度标记出现的位置，使用 setTickInterval() 来指定你希望有多少个刻度标记。当前设置的刻度位置和间隔可以通过 tickPosition() 和 tickInterval() 函数分别查询。

QSlider 继承了一组全面的信号：

信号

描述

valueChanged()

当滑块的值发生变化时发出。tracking() 决定此信号是否在用户交互期间发出。

sliderPressed()

当用户开始拖动滑块时发出。

sliderMoved()

当用户拖动滑块时发出。

sliderReleased()

当用户释放滑块时发出。

信号	描述
`valueChanged()`	当滑块的值发生变化时发出。tracking() 决定此信号是否在用户交互期间发出。
`sliderPressed()`	当用户开始拖动滑块时发出。
`sliderMoved()`	当用户拖动滑块时发出。
`sliderReleased()`	当用户释放滑块时发出。

QSlider 只提供整数范围。请注意，尽管 QSlider 可以处理非常大的数字，但对于非常大的范围，用户很难准确地使用滑块。

滑块在按下Tab键时接受焦点，并提供鼠标滚轮和键盘接口。键盘接口如下：

左/右移动水平滑块一步。

向上/向下移动垂直滑块一个单步。

PageUp 向上移动一页。

PageDown 向下移动一页。

主页移动到开始（最小）。

End 移动到末尾（最大值）。

另请参阅

QScrollBar QSpinBox QDial 滑块示例

class TickPosition¶

此枚举指定了刻度标记相对于滑块的凹槽和用户移动的把手绘制的位置。

常量

描述

QSlider.NoTicks

不绘制任何刻度标记。

QSlider.TicksBothSides

在凹槽的两侧绘制刻度标记。

QSlider.TicksAbove

在（水平）滑块上方绘制刻度标记

QSlider.TicksBelow

在（水平）滑块下方绘制刻度标记

QSlider.TicksLeft

在（垂直）滑块的左侧绘制刻度标记

QSlider.TicksRight

在（垂直）滑块的右侧绘制刻度标记

常量	描述
QSlider.NoTicks	不绘制任何刻度标记。
QSlider.TicksBothSides	在凹槽的两侧绘制刻度标记。
QSlider.TicksAbove	在（水平）滑块上方绘制刻度标记
QSlider.TicksBelow	在（水平）滑块下方绘制刻度标记
QSlider.TicksLeft	在（垂直）滑块的左侧绘制刻度标记
QSlider.TicksRight	在（垂直）滑块的右侧绘制刻度标记

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property tickIntervalᅟ: int¶

此属性保存刻度标记之间的间隔。

这是一个值区间，而不是像素区间。如果为0，滑块将在singleStep和pageStep之间选择。

默认值为0。

另请参阅

tickPosition singleStep pageStep

Access functions:

tickInterval()
setTickInterval()

property tickPositionᅟ: QSlider.TickPosition¶

此属性保存此滑块的刻度位置。

有效值由TickPosition枚举描述。

默认值为 NoTicks 。

另请参阅

tickInterval

Access functions:

tickPosition()
setTickPosition()

__init__([parent=None])¶

Parameters:: 父级 – QWidget

使用给定的parent构建一个垂直滑块。

__init__(orientation[, parent=None])

Parameters:

orientation – Orientation
parent – QWidget

使用给定的parent构建一个滑块。orientation参数决定滑块是水平还是垂直；有效值为Qt::Vertical和Qt::Horizontal。

initStyleOption(option)¶

Parameters:: 选项 – QStyleOptionSlider

使用来自此QSlider的值初始化option。当子类需要QStyleOptionSlider但不想自己填写所有信息时，此方法非常有用。

另请参阅

initFrom()

setTickInterval(ti)¶

Parameters:: ti – 整数

另请参阅

tickInterval()

属性 tickIntervalᅟ 的设置器。

setTickPosition(position)¶

Parameters:: position – TickPosition

另请参阅

tickPosition()

属性 tickPositionᅟ 的设置器。

tickInterval()¶

Return type:: 整数

另请参阅

setTickInterval()

属性 tickIntervalᅟ 的获取器。

tickPosition()¶

Return type:: TickPosition

另请参阅

setTickPosition()

属性 tickPositionᅟ 的获取器。