Used to select a value by sliding a handle along a track. 更多...
import 语句: | import QtQuick.Controls |
继承: |
(since QtQuick.Controls 2.3 (Qt 5.10))
(since QtQuick.Controls 2.5 (Qt 5.12))
(since QtQuick.Controls 2.5 (Qt 5.12))
(since QtQuick.Controls 2.2 (Qt 5.9))
(since QtQuick.Controls 2.5 (Qt 5.12))
(since QtQuick.Controls 2.3 (Qt 5.10))
(since QtQuick.Controls 2.2 (Qt 5.9))
(since QtQuick.Controls 2.1 (Qt 5.8))
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 }
The
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 .
horizontal
:
bool
|
This property holds whether the slider is horizontal.
该特性在 QtQuick.Controls 2.3 (Qt 5.10) 引入。
另请参阅 orientation .
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 .
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 .
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 .
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
.
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 .
vertical
:
bool
|
This property holds whether the slider is vertical.
该特性在 QtQuick.Controls 2.3 (Qt 5.10) 引入。
另请参阅 orientation .
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 .
|
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 .
|
Returns the value for the given position .
This method was introduced in QtQuick.Controls 2.1 (Qt 5.8).