Switch QML Type

Bouton à bascule permettant d'activer ou de désactiver une option. En savoir plus...

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

Propriétés

• position : real
• visualPosition : real

Description détaillée

Le commutateur est un bouton d’option qui peut être déplacé 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, tels que ceux figurant dans une liste, envisagez plutôt d’utiliser SwitchDelegate.

Le commutateur hérite de son API de l'AbstractButton. Par exemple, l'état du commutateur peut être défini à l'aide de la propriété checked. Les signaux clicked et AbstractButton::toggled sont émis lorsque l'utilisateur clique de manière interactive sur le commutateur via un écran tactile, une souris ou un 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 également Personnalisation des contrôles de type «Switch » et « Bouton ».

Documentation sur les propriétés

position : real [read-only]

Cette propriété définit la position logique de l'indicateur de défilement.

La position est exprimée sous forme de fraction de la taille de l'indicateur, dans l'intervalle 0.0 - 1.0. La position peut être utilisée, par exemple, pour déterminer si le curseur a été déplacé au-delà de la moitié. Pour afficher un indicateur de curseur, il convient d'utiliser à la place la propriété « visualPosition », qui prend en charge l'affichage de droite à gauche.

Voir également visualPosition.

visualPosition : real [read-only]

Cette propriété définit la position visuelle du curseur.

La position est exprimée sous forme de fraction de la taille de l’indicateur, comprise entre 0.0 et 1.0. Lorsque le contrôle est en mode « mirrored », la valeur est égale à 1.0 - position. Cela permet d’utiliser cette valeur pour visualiser l’indicateur à curseur en tenant compte de la prise en charge de la lecture de droite à gauche. Afin de déterminer, par exemple, si le curseur a été déplacé au-delà de la moitié de la plage, il convient d’utiliser à la place l’ position.

Voir également position.