En esta página

ShadowStyle QML Type

Define el estilo de la sombra proyectada de un delegado. Más información...

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

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Propiedades

Descripción detallada

ShadowStyle proporciona propiedades para renderizar una sombra proyectada detrás de un elemento « DelegateStyle ». Está disponible como la propiedad agrupada « shadow » en cualquier delegado.

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

Al ajustar la escala y el color, las sombras también pueden utilizarse para crear efectos de resplandor. El siguiente fragmento de código añade un resplandor blanco difuso al controlador de un ` Switch ` que se intensifica cuando se marca:

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
    }
}

Nota: No se garantiza que los tipos de los módulos de Qt.labs sigan siendo compatibles en futuras versiones.

Véase también « DelegateStyle» , « ControlStyle », « ControlStateStyle » y la «Referencia de FallbackStyle».

Documentación de la propiedad

blur : real

El desenfoque de la sombra. Un valor de 0.0 produce una sombra nítida, mientras que los valores más altos producen una sombra más suave y difusa. El valor por defecto es 10.0.

color : color

El color de la sombra. El valor por defecto es transparent, lo que significa que, de forma predeterminada, no se dibujará ninguna sombra.

Véase también visible y opacity.

delegate : Component

Un componente QML personalizado, « Component », que sustituye la representación predeterminada de la sombra. Cuando se activa, StyleKit crea una instancia de este componente en lugar de dibujar la sombra predeterminada.

horizontalOffset : real

El desplazamiento horizontal de la sombra del delegado, en píxeles.

opacity : real

La opacidad de la sombra, desde 0.0 (totalmente transparente) hasta 1.0 (totalmente opaca). El valor por defecto es 1.0.

Véase también visible y color.

scale : real

El factor de escala de la sombra con respecto al delegado. El valor por defecto es 1.0.

verticalOffset : real

El desplazamiento vertical de la sombra del delegado, en píxeles.

visible : bool

Si la sombra es visible. El valor por defecto es true.

Sin embargo, dado que el color predeterminado de la sombra color es transparent, la sombra no será visible a menos que se establezca un color diferente.

Véase también 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.