Slider QML Type

Provides a vertical or horizontal slider control. 更多...

import 语句: import QtQuick.Controls 1.4
Since: Qt 5.1
继承:

FocusScope

特性

详细描述

The slider is the classic control for providing a bounded value. It lets the user move a slider handle along a horizontal or vertical groove and translates the handle's position into a value within the legal range.

Slider {
    value: 0.5
}
					

The slider value is by default in the range [0, 1]. If integer values are needed, you can set the stepSize .

You can create a custom appearance for a Slider by assigning a SliderStyle .

特性文档编制

activeFocusOnPress : bool

This property indicates whether the slider should receive active focus when pressed.

[read-only] hovered : bool

This property indicates whether the slider handle is being hovered.

maximumValue : real

This property holds the maximum value of the slider. The default value is 1.0 .

minimumValue : real

This property holds the minimum value of the slider. The default value is 0.0 .

orientation : int

This property holds the layout orientation of the slider. The default value is Qt.Horizontal .

[read-only] pressed : bool

This property indicates whether the slider handle is being pressed.

stepSize : real

This property indicates the slider step size.

A value of 0 indicates that the value of the slider operates in a continuous range between minimumValue and maximumValue .

Any non 0 value indicates a discrete stepSize. The following example will generate a slider with integer values in the range [0-5].

Slider {
    maximumValue: 5.0
    stepSize: 1.0
}
					

默认值为 0.0 .

tickmarksEnabled : bool

This property indicates whether the slider should display tickmarks at step intervals. Tick mark spacing is calculated based on the stepSize 特性。

默认值为 false .

注意: This property may be ignored on some platforms when using the native style (e.g. Android).

updateValueWhileDragging : bool

This property indicates whether the current value should be updated while the user is moving the slider handle, or only when the button has been released. This property could for instance be modified if changing the slider value would turn out to be too time consuming.

默认值为 true .

value : real

This property holds the current value of the slider. The default value is 0.0 .

wheelEnabled : bool

This property determines whether the control handles wheel events. The default value is true .

This property was introduced in QtQuick.Controls 1.6.