- Qt 6.9
- Qt Quick Controls
- QML Types
- Switch
- Qt 6.9.3 Reference Documentation

# Switch QML Type

Switch button that can be toggled on or off. More...

Import Statement: | `import QtQuick.Controls`
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. For larger sets of options, such as those in a list, consider using SwitchDelegate instead.

Switch inherits its API from AbstractButton. For instance, the state of the switch can be set with the checked property. The clicked and AbstractButton::toggled signals are emitted when the switch is interactively clicked by the user via touch, mouse, or keyboard.

     ColumnLayout {
         Switch {
             text: qsTr("Wi-Fi")
             checked: Networking.wifiEnabled
             onClicked: Networking.wifiEnabled = checked
         }
         Switch {
             text: qsTr("Bluetooth")
             checked: Networking.bluetoothEnabled
             onClicked: Networking.bluetoothEnabled = checked
         }
     }

See also Customizing Switch and Button Controls.

## Property Documentation

position : real `[read-only]`

This property holds the logical position of the thumb indicator.

The position is expressed as a fraction of the indicator's size, in the range `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.

visualPosition : real `[read-only]`

This property holds the visual position of the thumb indicator.

The position is expressed as a fraction of the indicator's size, in the range `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.