Qt Documentation

Contents

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

Properties

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.


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