RangeSlider QML Type

用于通过沿轨道滑动两个手柄来选择数值范围。更多

• 所有成员（包括继承成员）的列表

属性

• first
  • first.handle : Item
  • first.hovered : bool
  • first.implicitHandleHeight : real
  • first.implicitHandleWidth : real
  • first.position : real
  • first.pressed : bool
  • first.value : real
  • first.visualPosition : real
• from : real
• horizontal : bool (since QtQuick.Controls 2.3 (Qt 5.10))
• live : bool (since QtQuick.Controls 2.2 (Qt 5.9))
• orientation : enumeration
• second
  • second.handle : Item
  • second.hovered : bool
  • second.implicitHandleHeight : real
  • second.implicitHandleWidth : real
  • second.position : real
  • second.pressed : bool
  • second.value : real
  • second.visualPosition : real
• snapMode : enumeration
• stepSize : real
• to : real
• touchDragThreshold : real (since QtQuick.Controls 2.5 (Qt 5.12))
• vertical : bool (since QtQuick.Controls 2.3 (Qt 5.10))

信号

• void first.moved() (since QtQuick.Controls 2.5)
• void second.moved() (since QtQuick.Controls 2.5)

方法

• void first.decrease()
• void first.increase()
• void second.decrease()
• void second.increase()
• void setValues(real firstValue, real secondValue)
• real valueAt(real position) (since QtQuick.Controls 2.5 (Qt 5.12))

详细说明

RangeSlider 用于通过沿轨道滑动每个手柄来选择由两个值指定的范围。

在下面的示例中，设置了自定义from 和to 值，并设置了first 和second 手柄的初始位置：

RangeSlider {
    from: 1
    to: 100
    first.value: 25
    second.value: 75
}

要在特定句柄的值发生变化时执行操作，请使用以下语法：

first.onMoved: console.log("first.value changed to " + first.value)

first.position 和second.position 属性以控件大小的分数表示，范围为0.0 - 1.0 。first.visualPosition 和second.visualPosition 属性是相同的，只是在从右到左的应用程序中它们的位置相反。visualPosition 在为 RangeSlider 定型时用于定位手柄。在上面的示例中，在从左到右的应用中，first.visualPosition 将是0.24 ，而在从右到左的应用中，0.76 。

有关允许用户选择单个值的滑块，请参阅Slider 。

另请参阅 Qt Quick 控件中的自定义 RangeSlider、输入控件和焦点管理。

属性文档

first group

另请参阅 first.moved(),first.increase() 和first.decrease()。

from : real

该属性保存范围的起始值。默认值为0.0 。

另请参阅 to,first.value, 和second.value 。

horizontal : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

该属性表示滑块是否水平。

该属性在 QtQuick.Controls 2.3 (Qt 5.10) 中引入。

另请参阅 orientation 。

live : bool [since QtQuick.Controls 2.2 (Qt 5.9)]

该属性用于保存滑块是否在拖动各自的手柄时为first.value 和second.value 属性提供实时更新。

默认值为true 。

该属性在 QtQuick.Controls 2.2 (Qt 5.9) 中引入。

另请参阅 first.value 和second.value 。

orientation : enumeration

此属性表示方向。

可能的值

另请参阅 horizontal 和vertical 。

second group

另请参阅 second.moved(),second.increase() 和second.decrease()。

snapMode : enumeration

该属性用于保存抓取模式。

捕捉模式决定了滑块手柄在stepSize 上的行为方式。

可能的值

有关各种模式的直观说明，请参阅snapMode 文档Slider 。

另请参见 stepSize 。

stepSize : real

该属性表示步长。默认值为0.0 。

另请参阅 snapMode,first.increase() 和first.decrease() 。

to : real

该属性用于保存范围的终值。默认值为1.0 。

另请参阅 from,first.value, 和second.value 。

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

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

此属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 QStyleHints 。

vertical : bool [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

该属性表示滑块是否垂直。

该属性在 QtQuick.Controls 2.3 (Qt 5.10) 中引入。

另请参阅 orientation 。

信号文档

当用户通过触摸、鼠标或按键交互移动第一个或第二个句柄时，就会发出该信号。

这些信号在 QtQuick.Controls 2.5 中引入。

另请参阅 first 和second 。

方法文档

void first.decrease()

通过stepSize 减少句柄的值，如果stepSize 没有定义，则通过0.1 减少句柄的值。

另请参见 first 。

void first.increase()

通过stepSize 增加句柄的值，如果stepSize 没有定义，则通过0.1 增加句柄的值。

另请参阅 first 。

void second.decrease()

通过stepSize 减少句柄的值，如果stepSize 没有定义，则通过0.1 减少句柄的值。

另请参见 second 。

void second.increase()

通过stepSize 增加句柄的值，如果stepSize 没有定义，则通过0.1 增加句柄的值。

另请参阅 second 。

void setValues(real firstValue, real secondValue)

使用给定参数设置first.value 和second.value 。

如果to 大于from ，且firstValue 大于secondValue ，则 firstValue 将与 secondValue 夹紧。

如果from 大于to ，且 secondValue 大于 firstValue，则 secondValue 将箝位到 firstValue。

由于 firstValue 和 secondValue 之间存在循环依赖关系，可能导致分配的值相互箝位，因此可能需要在控制完成后使用此函数设置第一和第二值。

另请参见 stepSize 。

[since QtQuick.Controls 2.5 (Qt 5.12)] real valueAt(real position)

返回给定position 的值。

此方法在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅 first.value,second.value,first.position,second.position 和live 。