Used to select a value by sliding a handle along a track. 更多...
导入语句: | import QtQuick.Controls 2.2 |
Since: | Qt 5.7 |
继承: | Control |
Slider is used to select a value by sliding a handle along a track.
在以下范例中,自定义 from , value ,和 to values are set:
Slider { from: 1 value: 25 to: 100 }
position
property is expressed as a fraction of the control's size, in the range
0.0 - 1.0
。
visualPosition
property is the same, except that it is reversed in a
right-to-left
application. The
visualPosition
is useful for positioning the handle when styling Slider. In the example above,
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 range by providing two handles, see RangeSlider .
另请参阅 Customizing Slider and 输入控件 .
from : real |
This property holds the starting value for the range. The default value is
0.0
.
handle : Item |
This property holds the handle item.
另请参阅 Customizing Slider .
[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 .
[read-only, since QtQuick.Controls 2.5 (Qt 5.12)] implicitHandleHeight : real |
This property holds the implicit handle height.
值等于
handle ? handle.implicitHeight : 0
.
This is typically used, together with implicitContentHeight and implicitBackgroundHeight , to calculate the implicitHeight .
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 implicitHandleWidth .
[read-only, since QtQuick.Controls 2.5 (Qt 5.12)] implicitHandleWidth : real |
This property holds the implicit handle width.
值等于
handle ? handle.implicitWidth : 0
.
This is typically used, together with implicitContentWidth and implicitBackgroundWidth , to calculate the implicitWidth .
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 implicitHandleHeight .
[since QtQuick.Controls 2.2 (Qt 5.9)] live : bool |
This property holds whether the slider provides live updates for the value property while the handle is dragged.
默认值为
true
.
This property was introduced in QtQuick.Controls 2.2 (Qt 5.9).
orientation : enumeration |
This property holds the orientation.
可能的值:
常量 | 描述 |
---|---|
Qt.Horizontal
|
Horizontal (default) |
Qt.Vertical
|
Vertical |
另请参阅 horizontal and vertical .
[read-only] position : real |
This property holds the logical position of the handle.
The position is expressed as a fraction of the control's size, in the range
0.0 - 1.0
. For visualizing a slider, the right-to-left aware
visualPosition
应该被使用以取而代之。
另请参阅 value , visualPosition ,和 valueAt() .
pressed : bool |
This property holds whether the slider is pressed by either touch, mouse, or keys.
snapMode : enumeration |
This property holds the snap mode.
The snap mode determines how the slider handle behaves with regards to the stepSize .
可能的值:
常量 | 描述 |
---|---|
Slider.NoSnap
|
The slider does not snap (default). |
Slider.SnapAlways
|
The slider snaps while the handle is dragged. |
Slider.SnapOnRelease
|
The slider does not snap while being dragged, but only after the handle is released. |
In the following table, the various modes are illustrated with animations. The movement of the mouse cursor and the
stepSize
(
0.2
) are identical in each animation.
值 | 范例 |
Slider.NoSnap
|
|
Slider.SnapAlways
|
|
Slider.SnapOnRelease
|
另请参阅 stepSize .
stepSize : real |
This property holds the step size. The default value is
0.0
.
另请参阅 snapMode , increase() ,和 decrease() .
to : real |
This property holds the end value for the range. The default value is
1.0
.
[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 .
value : real |
This property holds the value in the range
from
-
to
。默认值为
0.0
.
另请参阅 position .
[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 .
[read-only] visualPosition : real |
This property holds the visual position of the handle.
The position is expressed as a fraction of the control's size, in the range
0.0 - 1.0
. When the control is
mirrored
, the value is equal to
1.0 - position
. This makes the value suitable for visualizing the slider, taking right-to-left support into account.
另请参阅 position .
[since QtQuick.Controls 2.2 (Qt 5.9)]
moved
()
|
This signal is emitted when the slider has been interactively moved by the user by either touch, mouse, wheel, or keys.
注意:
相应处理程序是
onMoved
.
This signal was introduced in QtQuick.Controls 2.2 (Qt 5.9).
void decrease () |
Decreases the value by
stepSize
or
0.1
if
stepSize
is not defined.
另请参阅 stepSize .
void increase () |
Increases the value by
stepSize
or
0.1
if
stepSize
is not defined.
另请参阅 stepSize .
[since QtQuick.Controls 2.1 (Qt 5.8)]
real
valueAt
(
real
position
)
|
Returns the value for the given position .
This method was introduced in QtQuick.Controls 2.1 (Qt 5.8).