用于通过沿轨道滑动 2 手柄来选择值范围。 更多...
导入语句: | import QtQuick.Controls 2.2 |
Since: | Qt 5.7 |
继承: | Control |
RangeSlider is used to select a range specified by two values, by sliding each handle along a track.
在以下范例中,自定义 from and to values are set, and the initial positions of the first and second handles are set:
RangeSlider { from: 1 to: 100 first.value: 25 second.value: 75 }
In order to perform an action when the value for a particular handle changes, use the following syntax:
first.onMoved: console.log("first.value changed to " + first.value)
first.position
and
second.position
properties are expressed as fractions of the control's size, in the range
0.0 - 1.0
。
first.visualPosition
and
second.visualPosition
properties are the same, except that they are reversed in a
right-to-left
application. The
visualPosition
is useful for positioning the handles when styling RangeSlider. In the example above,
first.visualPosition
将是
0.24
in a left-to-right application, and
0.76
in a right-to-left application.
For a slider that allows the user to select a single value, see Slider .
另请参阅 Customizing RangeSlider , 输入控件 ,和 Focus Management in Qt Quick Controls .
first group |
---|
first.handle : Item |
first.hovered : bool |
first.implicitHandleHeight : real |
first.implicitHandleWidth : real |
first.position : real |
first.pressed : bool |
first.value : real |
first.visualPosition : real |
特性 | 描述 |
---|---|
值 |
This property holds the value of the first handle in the range
from
-
to
.
若 from 大于 to , the value of the first handle must be greater than the second, and vice versa.
默认值为
|
handle | This property holds the first handle item. |
visualPosition |
This property holds the visual position of the first handle.
The position is expressed as a fraction of the control's size, in the range
|
位置 |
This property holds the logical position of the first handle.
The position is expressed as a fraction of the control's size, in the range
|
pressed | This property holds whether the first handle is pressed by either touch, mouse, or keys. |
hovered | This property holds whether the first handle is hovered. This property was introduced in QtQuick .Controls 2.1. |
implicitHandleWidth | This property holds the implicit width of the first handle. This property was introduced in QtQuick .Controls 2.5. |
implicitHandleHeight | This property holds the implicit height of the first handle. This property was introduced in QtQuick .Controls 2.5. |
另请参阅 first.moved() , first.increase() ,和 first.decrease() .
from : real |
This property holds the starting value for the range. The default value is
0.0
.
另请参阅 to , first.value ,和 second.value .
[read-only, since QtQuick.Controls 2.3 (Qt 5.10)] horizontal : bool |
This property holds whether the slider is horizontal.
该特性在 QtQuick.Controls 2.3 (Qt 5.10) 引入。
另请参阅 orientation .
[since QtQuick.Controls 2.2 (Qt 5.9)] live : bool |
This property holds whether the slider provides live updates for the first.value and second.value properties while the respective handles are dragged.
默认值为
true
.
This property was introduced in QtQuick.Controls 2.2 (Qt 5.9).
另请参阅 first.value and second.value .
orientation : enumeration |
This property holds the orientation.
可能的值:
常量 | 描述 |
---|---|
Qt.Horizontal
|
Horizontal (default) |
Qt.Vertical
|
Vertical |
另请参阅 horizontal and vertical .
second group |
---|
second.handle : Item |
second.hovered : bool |
second.implicitHandleHeight : real |
second.implicitHandleWidth : real |
second.position : real |
second.pressed : bool |
second.value : real |
second.visualPosition : real |
特性 | 描述 |
---|---|
值 |
This property holds the value of the second handle in the range
from
-
to
.
若 from 大于 to , the value of the first handle must be greater than the second, and vice versa.
默认值为
|
handle | This property holds the second handle item. |
visualPosition |
This property holds the visual position of the second handle.
The position is expressed as a fraction of the control's size, in the range
|
位置 |
This property holds the logical position of the second handle.
The position is expressed as a fraction of the control's size, in the range
|
pressed | This property holds whether the second handle is pressed by either touch, mouse, or keys. |
hovered | This property holds whether the second handle is hovered. This property was introduced in QtQuick .Controls 2.1. |
implicitHandleWidth | This property holds the implicit width of the second handle. This property was introduced in QtQuick .Controls 2.5. |
implicitHandleHeight | This property holds the implicit height of the second handle. This property was introduced in QtQuick .Controls 2.5. |
另请参阅 second.moved() , second.increase() ,和 second.decrease() .
snapMode : enumeration |
This property holds the snap mode.
The snap mode determines how the slider handles behave with regards to the stepSize .
可能的值:
常量 | 描述 |
---|---|
RangeSlider.NoSnap
|
The slider does not snap (default). |
RangeSlider.SnapAlways
|
The slider snaps while the handle is dragged. |
RangeSlider.SnapOnRelease
|
The slider does not snap while being dragged, but only after the handle is released. |
For visual explanations of the various modes, see the snapMode documentation of Slider .
另请参阅 stepSize .
stepSize : real |
This property holds the step size. The default value is
0.0
.
另请参阅 snapMode , first.increase() ,和 first.decrease() .
to : real |
This property holds the end value for the range. The default value is
1.0
.
另请参阅 from , first.value ,和 second.value .
[since QtQuick.Controls 2.5 (Qt 5.12)] touchDragThreshold : qreal |
This property holds the threshold (in logical pixels) at which a touch drag event will be initiated. The mouse drag threshold won't be affected. The default value is
Qt.styleHints.startDragDistance
.
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 QStyleHints .
[read-only, since QtQuick.Controls 2.3 (Qt 5.10)] vertical : bool |
This property holds whether the slider is vertical.
该特性在 QtQuick.Controls 2.3 (Qt 5.10) 引入。
另请参阅 orientation .
[since QtQuick.Controls 2.5]
void
first.moved
()
|
[since QtQuick.Controls 2.5]
void
second.moved
()
|
This signal is emitted when either the first or second handle has been interactively moved by the user by either touch, mouse, or keys.
This QML signal was introduced in QtQuick.Controls 2.5.
void first.decrease () |
Decreases the value of the handle by
stepSize
,或
0.1
if
stepSize
is not defined.
另请参阅 first .
void first.increase () |
Increases the value of the handle by
stepSize
,或
0.1
if
stepSize
is not defined.
另请参阅 first .
void second.decrease () |
Decreases the value of the handle by
stepSize
,或
0.1
if
stepSize
is not defined.
另请参阅 second .
void second.increase () |
Increases the value of the handle by
stepSize
,或
0.1
if
stepSize
is not defined.
另请参阅 second .
void setValues ( real firstValue , real secondValue ) |
设置 first.value and second.value with the given arguments.
若 to is larger than from and firstValue is larger than secondValue , firstValue will be clamped to secondValue.
若 from is larger than to and secondValue is larger than firstValue, secondValue will be clamped to firstValue.
This function may be necessary to set the first and second values after the control has been completed, as there is a circular dependency between firstValue and secondValue which can cause assigned values to be clamped to each other.
另请参阅 stepSize .
[since QtQuick.Controls 2.5 (Qt 5.12)]
real
valueAt
(
real
position
)
|
Returns the value for the given position .
This method was introduced in QtQuick.Controls 2.5 (Qt 5.12).
另请参阅 first.value , second.value , first.position , second.position ,和 live .