Sur cette page

ShadowStyle QML Type

Définit le style d'ombre portée d'un délégué. En savoir plus…

Import Statement: import Qt.labs.StyleKit
Status: Technology preview

Ce type est en préversion technologique et est susceptible d'être modifié.

Propriétés

Description détaillée

ShadowStyle fournit des propriétés permettant d'afficher une ombre portée derrière un élément DelegateStyle. Il est disponible sous la forme de la propriété groupée shadow sur n'importe quel délégué.

button {
    background {
        shadow {
            color: "lightgray"
            opacity: 0.6
            verticalOffset: 2
            horizontalOffset: 2
        }
    }
}

En ajustant l'échelle et la couleur, les ombres peuvent également être utilisées pour créer des effets de lueur. L'extrait de code suivant ajoute une lueur blanche diffuse à la poignée d'un élément « Switch » qui s'intensifie lorsque celui-ci est coché :

dark: Theme {
    applicationWindow.background.color: "#1e1e1e"
    switchControl {
        handle.color: "white"
        handle.shadow {
            color: "ghostwhite"
            scale: 1.2
            opacity: 0.6
        }
        checked.handle.shadow.scale: 1.5
    }
}

Remarque : la compatibilité des types des modules Qt.labs n’est pas garantie dans les versions futures.

Voir également DelegateStyle, ControlStyle, ControlStateStyle et la référence FallbackStyle.

Documentation sur les propriétés

blur : real

Le flou de l'ombre. Une valeur de 0.0 produit une ombre nette, tandis que des valeurs plus élevées produisent une ombre plus douce et plus diffuse. La valeur par défaut est 10.0.

color : color

La couleur de l'ombre. La valeur par défaut est transparent, ce qui signifie qu'aucune ombre ne sera dessinée par défaut.

Voir également visible et opacity.

delegate : Component

Un composant QML personnalisé ( Component ) qui remplace le rendu par défaut de l'ombre. Lorsqu'il est activé, StyleKit instancie ce composant au lieu de dessiner l'ombre par défaut.

horizontalOffset : real

Le décalage horizontal de l'ombre par rapport au délégué, en pixels.

opacity : real

L'opacité de l'ombre, allant de 0.0 (entièrement transparente) à 1.0 (entièrement opaque). La valeur par défaut est 1.0.

Voir également visible et color.

scale : real

Facteur d'échelle de l'ombre par rapport au délégué. La valeur par défaut est 1.0.

verticalOffset : real

Le décalage vertical de l'ombre par rapport au délégué, en pixels.

visible : bool

Indique si l'ombre est visible. La valeur par défaut est « true ».

Cependant, comme la couleur par défaut de l'color de l'ombre est transparent, celle-ci ne sera pas visible à moins qu'une autre couleur ne soit définie.

Voir également opacity.

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