Switch QML Type

Bouton interrupteur qui peut être activé ou désactivé. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• position : real
• visualPosition : real

Description détaillée

Un interrupteur est un bouton d'option qui peut être glissé ou activé (coché) ou désactivé (décoché). Les commutateurs sont généralement utilisés pour choisir entre deux états. Pour des ensembles d'options plus importants, comme ceux d'une liste, il est préférable d'utiliser SwitchDelegate.

Switch hérite de l'API de AbstractButton. Par exemple, l'état de l'interrupteur peut être défini à l'aide de la propriété checked. Les signaux clicked et AbstractButton::toggled sont émis lorsque l'utilisateur clique sur l'interrupteur par le biais du toucher, de la souris ou du clavier.

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

Voir aussi Personnalisation des contrôles de boutons et d'interrupteurs.

Documentation sur les propriétés

position : real [read-only]

Cette propriété indique la position logique de l'indicateur de pouce.

La position est exprimée en fraction de la taille de l'indicateur, dans la plage 0.0 - 1.0. La position peut être utilisée, par exemple, pour déterminer si le pouce a été déplacé au-delà du point médian. Pour visualiser un indicateur de pouce, il convient d'utiliser plutôt l'indicateur de droite à gauche visualPosition.

Voir également visualPosition.

visualPosition : real [read-only]

Cette propriété définit la position visuelle de l'indicateur du pouce.

La position est exprimée en fraction de la taille de l'indicateur, dans la plage 0.0 - 1.0. Lorsque le contrôle est mirrored, la valeur est égale à 1.0 - position, ce qui permet de visualiser l'indicateur de pouce en tenant compte du support de droite à gauche. Pour déterminer, par exemple, si le pouce a été déplacé au-delà du point médian, il convient d'utiliser plutôt la valeur logique position.

Voir aussi position.