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

Qt 5.7.1 Reference Documentation

# SwitchDelegate QML Type

An item delegate that can be toggled on or off. More...

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

- List of all members, including inherited members

## Properties

- position : real
- visualPosition : real

## Detailed Description

SwitchDelegate presents an item delegate that can be toggled on (checked) or off (unchecked). Switch delegates are typically used to select one or more options from a set of options.

The state of the check delegate can be set with the checked property.

      ListView {
          model: ["Option 1", "Option 2", "Option 3"]
          delegate: SwitchDelegate {
              text: modelData
          }
      }

See also Customizing SwitchDelegate and Delegate 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.