On this page

RangeControl QML Type

A slider control for editing bounded numeric properties. More...

Import Statement: import QtInterfaceFramework.ControlPanelHelper 1.0
Inherits:

ColumnLayout

Properties

Signals

Detailed Description

RangeControl provides a styled Slider with labels that display the minimum, current, and maximum values. It is used by the simulation control panel for properties annotated with @range in the QFace IDL.

The slider supports discrete steps via the stepSize property and snaps to the nearest step when stepSize is greater than zero.

Usage

RangeControl {
    from: 0
    to: 100
    stepSize: 5
    value: backend.volume
    onMoved: function(value) {
        backend.setVolume(value)
    }
}

Property Documentation

from : real

This property holds the minimum allowed value of the slider.

By default, the property is set to the minimum 32-bit signed integer value (-2147483648).

stepSize : real

This property holds the step size for the slider. When set to a value greater than zero, the slider snaps to the nearest multiple of stepSize.

By default, the property is set to 1.

to : real

This property holds the maximum allowed value of the slider.

By default, the property is set to the maximum 32-bit signed integer value (2147483647).

value : real

This property holds the current value of the slider.

By default, the property is set to 0.

Signal Documentation

moved(real value)

This signal is emitted when the user moves the slider handle. The value parameter contains the new slider value.

Note: The corresponding handler is onMoved.

© 2026 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.