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()	当用户释放滑动条时发出。

QSlider 仅提供整数值范围。注意，尽管 QSlider 能够处理非常大的数字，但对于非常大的范围，用户使用滑块时可能会比较困难。

滑块在 Tab 键中可以接受焦点，并提供鼠标滚轮和键盘界面。键盘接口如下

• 上/下键使水平滑块移动一个单一步骤。

• 左/右键使垂直滑块移动一个单一步骤。

• PageUp 键向上翻一页。

• PageDown 键向下翻一页。

• Home 键移动到开始位置（最小值）。

• End 键移动到结束位置（最大值）。

参见

QScrollBar QSpinBox QDial 滑块示例

class TickPosition

此枚举指定刻度线相对于滑板的凹槽和用户移动的滑块手柄的绘制位置。

常量	描述
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

访问函数

• tickInterval()

• setTickInterval()

property tickPosition: QSlider.TickPosition

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

有效的值由 TickPosition 枚举描述。

默认值是 NoTicks 。

参见

tickInterval

访问函数

• tickPosition()

• setTickPosition()

__init__([parent=None])

参数：

parent – QWidget

通过给定的 parent 构造一个垂直滚动条。

__init__(orientation[, parent=None])

参数：

• orientation – Orientation

• parent – QWidget

通过与给定的 parent 构造一个滑动条。参数 orientation 决定滑动条是水平还是垂直；有效值是 Qt::Vertical 和 Qt::Horizontal。

initStyleOption(option)

参数：

option – QStyleOptionSlider

使用此 QSlider 的值初始化 option。此方法对于需要 QStyleOptionSlider 但又不想自行填写所有信息的子类非常有用。

参见

initFrom()

setTickInterval(ti)

参数：

ti – int

参见

tickInterval()

设置 tickInterval 属性的值。

setTickPosition(position)

参数：

position – TickPosition

参见

tickPosition()

设置 tickPosition 属性的值。

tickInterval()

返回类型：:

int

参见

setTickInterval()

属性 tickInterval 的获取器。

tickPosition()

返回类型：:

TickPosition

参见

setTickPosition()

属性 tickPosition 的获取器。