En esta página

ShadowStyle QML Type

Define el estilo de la sombra paralela de un delegado. Más...

Import Statement: import Qt.labs.StyleKit

Propiedades

Descripción detallada

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

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

Ajustando la escala y el color, las sombras también pueden utilizarse para crear efectos de brillo. El siguiente fragmento de código añade un resplandor blanco difuso al asa 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 Qt.labs sigan siendo compatibles en futuras versiones.

Véase también DelegateStyle, ControlStyle, ControlStateStyle, y FallbackStyle Reference.

Documentación de propiedades

blur : real

El desenfoque de la sombra. Un valor de 0.0 produce una sombra nítida, mientras que valores mayores 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 no se dibujará ninguna sombra por defecto.

Véase también visible y opacity.

delegate : Component

Un QML personalizado Component que sustituye al renderizado de sombras por defecto. Cuando se establece, StyleKit crea una instancia de este componente en lugar de dibujar la sombra predeterminada.

horizontalOffset : real

El desplazamiento horizontal de la sombra desde el 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 relativo al delegado. El valor por defecto es 1.0.

verticalOffset : real

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

visible : bool

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

Sin embargo, como la sombra por defecto 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.