滑动条 QML 类型

通过在轨道上移动滑块选择值。更多...

导入语句	import QtQuick.Controls
继承	Control

所有成员的列表，包括继承成员

属性

from : real
handle : Item
horizontal : bool (自 QtQuick.Controls 2.3 (Qt 5.10) 开始)
implicitHandleHeight : real (自 QtQuick.Controls 2.5 (Qt 5.12) 开始)
implicitHandleWidth : real (自 QtQuick.Controls 2.5 (Qt 5.12) 开始)
live : bool (自 QtQuick.Controls 2.2 (Qt 5.9) 开始)
orientation : 枚举
position : real
pressed : bool
snapMode : 枚举
stepSize : real
to : real
touchDragThreshold : qreal (自 QtQuick.Controls 2.5 (Qt 5.12) 开始)
value : real
vertical : bool (自 QtQuick.Controls 2.3 (Qt 5.10) 开始)
visualPosition : real

信号

moved() (自 QtQuick.Controls 2.2 (Qt 5.9) 开始)

方法

void decrease()
void increase()
real valueAt(real position) (自 QtQuick.Controls 2.1 (Qt 5.8) 开始)

详细描述

滑动条通过在轨道上滑动滑块来选择值。

以下示例中设置了自定义的 from、value 和 to 值

Slider {
    from: 1
    value: 25
    to: 100
}

位置属性用控件大小的一分数表示，范围在 0.0 - 1.0 之间。视觉位置属性（visualPosition）与位置属性相同，但在从右到左的应用程序中它会反向。视觉位置属性在为滑动条（Slider）进行样式设计时定位操作手柄很有用。在上面的例子中，左到右的应用程序中视觉位置将是 0.24，而在右到左的应用程序中将是 0.76。

关于允许用户通过提供两个操作手柄选择范围的滑动条，请参阅 RangeSlider。

另请参阅自定义滑动条和输入控件。

属性说明

from : 实数

此属性包含范围起始值。默认值为 0.0。

另请参阅to 和 value。

handle : 项

该属性包含手柄项。

另请参阅自定义滑动条。

horizontal : 布尔值 [只读，自 QtQuick.Controls 2.3（Qt 5.10）以来]

该属性表示滑动条是否为水平方向。

该属性自 QtQuick.Controls 2.3（Qt 5.10）以来被引入。

另请参阅orientation。

implicitHandleHeight : 实数 [只读，自 QtQuick.Controls 2.5（Qt 5.12）以来]

该属性包含隐式手柄高度。

该值等于 handle ? handle.implicitHeight : 0。

通常与 implicitContentHeight 和 implicitBackgroundHeight 一起使用，以计算 implicitHeight。

该属性自 QtQuick.Controls 2.5（Qt 5.12）以来被引入。

另请参阅implicitHandleWidth。

implicitHandleWidth : 实数 [只读，自 QtQuick.Controls 2.5（Qt 5.12）以来]

该属性包含隐式手柄宽度。

该值等于 handle ? handle.implicitWidth : 0。

通常与 implicitContentWidth 和 implicitBackgroundWidth 一起使用，以计算 implicitWidth。

该属性自 QtQuick.Controls 2.5（Qt 5.12）以来被引入。

另请参阅implicitHandleHeight。

live : 布尔值 [自 QtQuick.Controls 2.2（Qt 5.9）以来]

该属性表示滑动条是否在拖动手柄时实时更新 value 属性。

默认值为 true。

该属性自 QtQuick.Controls 2.2（Qt 5.9）以来被引入。

另请参阅value 和 valueAt。

orientation : 枚举

该属性包含方向。

可能值

常量	描述
`Qt.Horizontal`	水平（默认）
`Qt.Vertical`	垂直

参阅：水平horizontal 和 vertical。

位置 : 实数 [只读]

此属性保留滑块的逻辑位置。

位置以控制大小的分数表示，范围在 0.0 - 1.0 之间。为了可视化滑块，应使用左右感知的 visualPosition。

参阅：值value、visualPosition 和 valueAt。

按下 : 布尔类型

此属性表示滑块是否被触摸、鼠标或键盘按键按下。

snapMode : 枚举类型

此属性表示 snap 模式。

snap 模式决定了滑块手柄与 stepSize 的行为。

可能值

常量	描述
`Slider.NoSnap`	滑块不会自动定位（默认）。
`Slider.SnapAlways`	在拖动手柄时滑块将会自动定位。
`Slider.SnapOnRelease`	拖动时滑块不会自动定位，但只有在手柄释放后才会。

以下表格中，通过各种动画显示了不同的模式。在每一个动画中，鼠标光标和 stepSize (0.2) 都是相同的。