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

Properties

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.