滑动条 QML 类型

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

导入语句import QtQuick.Controls
继承

Control

属性

信号

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

方法

详细描述

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

以下示例中设置了自定义的 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) 都是相同的。
值示例
Slider.NoSnap

Slider.SnapAlways

Slider.SnapOnRelease

参阅：stepSize。


stepSize : 实数

此属性保留步长大小。默认值是 0.0。

参阅：snapMode、increase() 和 decrease()。


to : 实数

此属性保留范围的终点值。默认值是 1.0。

参阅：from 和 value。


touchDragThreshold : qreal [since QtQuick.Controls 2.5 (Qt 5.12)]

此属性保留了触发触摸拖动事件的阈值（以逻辑像素为单位）。鼠标拖动阈值不受影响。默认值是 Qt.styleHints.startDragDistance。

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

参阅：QStyleHints。


value : 实数

此属性保留了范围 from - to 内的值。默认值是 0.0。

参阅：position。


vertical : 布尔类型 [只读, since QtQuick.Controls 2.3 (Qt 5.10)]

此属性表示滑块是否是垂直的。

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

另请参阅orientation。


visualPosition : 实数 [只读]

此属性保留了手柄的视觉位置。

位置以控制大小的分数表示，范围在 0.0 - 1.0 之间。当控制被 镜像 时，值等于 1.0 - position。这使得值对于考虑左右支持的可视化滑块是合适的。

参阅：position。


信号文档

[since QtQuick.Controls 2.2 (Qt 5.9)] 移动()

当通过触摸、鼠标、滚轮或键盘按键与用户交互移动滑块时，会启动此信号。

注意：相应的处理程序是 onMoved。

此信号在 QtQuick.Controls 2.2（Qt 5.9）中引入。


方法文档

void decrease()

减少值通过步长或0.1，如果步长未定义。

参阅：stepSize。


void increase()

增加值通过步长或0.1，如果步长未定义。

参阅：stepSize。


[自 QtQuick.Controls 2.1（Qt 5.8）起] real valueAt(real position)

返回指定位置的值。

此方法在 QtQuick.Controls 2.1（Qt 5.8）中引入。

另请参阅：value和position。


© 2024 Qt公司。在此处包含的文档贡献是各自所有者的版权。所提供的文档是根据自由软件基金会发布的GNU自由文档许可协议版本1.3的条款许可的。Qt及其相关标志是芬兰的Qt公司及其在世界其他国家的商标。所有其他商标均归其各自所有者所有。