Qt 5.9 | Qt Quick Controls | QML Types | Slider QML Type

Qt 5.9.2 Reference Documentation

# Slider QML Type

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

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

- List of all members, including inherited members

## Properties

- activeFocusOnPress : bool
- hovered : bool
- maximumValue : real
- minimumValue : real
- orientation : int
- pressed : bool
- stepSize : real
- style : Component
- tickmarksEnabled : bool
- updateValueWhileDragging : bool
- value : real

## 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`.

style : Component

The style Component for this control.

See also Qt Quick Controls Styles QML Types.

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`.