Qt 5.7 | Qt Quick Controls 2 | QML Types | Switch QML Type

Qt 5.7.1 Reference Documentation

# Switch QML Type

An option button that can be toggled on or off. More...

Import Statement: | import QtQuick.Controls 2.0
Since: | Qt 5.7
Inherits: | AbstractButton

- List of all members, including inherited members

## Properties

- position : real
- visualPosition : real

## Detailed Description

Switch is an option button that can be dragged or toggled on (checked) or off (unchecked). Switches are typically used to select between two states.

| A switch in its normal state.
| A switch that is checked.
| A switch that has active focus.
| A switch that is disabled.

      ColumnLayout {
          Switch {
              text: qsTr("Wi-Fi")
          }
          Switch {
              text: qsTr("Bluetooth")
          }
      }

See also Customizing Switch and Button Controls.

## Property Documentation

[read-only] position : real

This property holds the logical position of the thumb indicator.

The position is defined as a percentage of the indicator's size, scaled to `0.0` - `1.0`. The position can be used for example to determine whether the thumb has been dragged past the halfway point. For visualizing a thumb indicator, the right-to-left aware visualPosition should be used instead.

See also visualPosition.

[read-only] visualPosition : real

This property holds the visual position of the thumb indicator.

The position is defined as a percentage of the indicator's size, scaled to `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 thumb indicator taking right-to-left support into account. In order to for example determine whether the thumb has been dragged past the halfway point, the logical position should be used instead.

See also position.