Qt Documentation

Contents

Slider QML Type

Provides a vertical or horizontal slider control. More...

Import Statement: import QtQuick.Controls 1.4
Since: Qt 5.1
Inherits:

FocusScope

Properties

Detailed Description

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.

Property Documentation

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
}

The default value is 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 property.

The default value is false.

Note: 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.

The default value is 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.


© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.