Sur cette page

SwitchDelegate QML Type

Élément délégué doté d'un indicateur de commutation pouvant être activé ou désactivé. En savoir plus...

Import Statement: import QtQuick.Controls
Inherits:

ItemDelegate

Propriétés

Description détaillée

SwitchDelegate propose un délégué d'élément pouvant être activé (coché) ou désactivé (décoché). Les délégués Switch sont généralement utilisés pour sélectionner une ou plusieurs options parmi un ensemble d'options. Pour les petits ensembles d'options, ou pour les options devant être identifiables de manière unique, envisagez plutôt d'utiliser Switch.

SwitchDelegate hérite de son API de ` ItemDelegate`, qui hérite lui-même de ` AbstractButton`. Par exemple, vous pouvez définir ` text` et réagir à ` clicks ` à l’aide de l’API ` AbstractButton `. L’état du délégué de commutateur peut être défini à l’aide de la propriété ` checked `.

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

Voir également Personnalisation de SwitchDelegate et des contrôles délégués.

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é de la plage. Pour visualiser un indicateur de curseur, il convient d'utiliser à la place la propriété « visualPosition », qui prend en charge la lecture 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 de 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.

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