Sur cette page

IndicatorStyle QML Type

Définit le style de l'indicateur d'un contrôle. Plus d'informations...

Import Statement: import Qt.labs.StyleKit
Inherits:

DelegateStyle

Propriétés

Description détaillée

IndicatorStyle étend DelegateStyle avec des propriétés qui sont spécifiques au style d'un indicateur.

L'IndicatorStyle lui-même décrit l'arrière-plan de l'indicateur, tandis que foreground décrit le contenu dessiné à l'intérieur. Par exemple, checkBox.indicator donne un style au cadre de la case à cocher et checkBox.indicator.foreground donne un style à la coche. Pour switchControl, slider et progressBar, l'indicateur définit le sillon et l'avant-plan définit le remplissage.

checkBox {
    background.visible: false
    text.alignment: Qt.AlignVCenter | Qt.AlignLeft
    indicator {
        color: "transparent"
        border.width: 1
        foreground {
            color: "transparent"
            image.source: "qrc:/qt-project.org/imports/QtQuick/Controls/Basic/images/check.png"
            // Hide the checkMark when the CheckBox is unchecked
            visible: false
        }
    }
    checked {
        // Show the checkMark when the CheckBox is checked
        indicator.foreground.visible: true
    }
}

Certains contrôles ont plus d'un indicateur. Par exemple, SpinBox possède un bouton d'incrémentation et un bouton de décrémentation. Ceux-ci peuvent être stylisés indépendamment à l'aide des sous-indicateurs up et down, spinBox.indicator.up et spinBox.indicator.down. Les propriétés qui ne sont pas définies sur un sous-indicateur reviennent à l'indicateur lui-même.

spinBox {
    text.alignment: Qt.AlignHCenter | Qt.AlignVCenter
    padding: 0
    indicator {
        implicitHeight: Style.Stretch
        color: "navy"
        opacity: 0.1
        foreground {
            color: "transparent"
            margins: 10
            image.color: "navy"
            image.fillMode: Image.PreserveAspectFit
            image.source: "qrc:/qt-project.org/imports/QtQuick/Controls/Basic/images/arrow-indicator.png"
            implicitWidth: 10
            implicitHeight: 10
            alignment: Qt.AlignCenter
        }
        down {
            alignment: Qt.AlignLeft
            foreground.rotation: 90
        }
        up {
            alignment: Qt.AlignRight
            foreground.rotation: -90
        }
    }
}

Note : La compatibilité des types dans les modules Qt.labs n'est pas garantie dans les versions futures.

Voir également SubIndicatorStyle, DelegateStyle, ControlStyle, ControlStateStyle, et FallbackStyle Reference.

Documentation sur les propriétés

down : SubIndicatorStyle

Propriété groupée permettant de styliser le sous-indicateur "down" (décrément). Elle est utilisée par des contrôles tels que SpinBox. Les propriétés non définies reviennent à l'indicateur lui-même.

Voir également up.

foreground : DelegateStyle

Propriété groupée permettant de styliser l'élément de premier plan de cet indicateur. Par exemple, checkBox.indicator décrit le cadre de la case à cocher, tandis que checkBox.indicator.foreground représente la coche.

Pour les contrôles tels que slider, progressBar, et switchControl, indicator.foreground représente la piste de progression ou le remplissage à l'intérieur du sillon, tandis que indicator lui-même représente le sillon.

up : SubIndicatorStyle

Propriété groupée pour styliser le sous-indicateur up (incrément). Elle est utilisée par des contrôles tels que SpinBox. Les propriétés non définies reviennent à l'indicateur lui-même.

Voir également down.

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