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
- blur : real
- color : color
- delegate : Component
- horizontalOffset : real
- opacity : real
- scale : real
- verticalOffset : real
- visible : bool
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.