ShadowStyle QML Type

Defines the drop shadow style for a delegate. More...

• List of all members, including inherited members

Properties

• blur : real
• color : color
• delegate : Component
• horizontalOffset : real
• opacity : real
• scale : real
• verticalOffset : real
• visible : bool

Detailed Description

ShadowStyle provides properties for rendering a drop shadow behind a DelegateStyle. It is available as the shadow grouped property on any delegate.

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

By adjusting scale and color, shadows can also be used to create glow effects. The following snippet adds a diffuse white glow to the handle of a Switch that intensifies when checked:

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

See also DelegateStyle, ControlStyle, ControlStateStyle, and FallbackStyle Reference.

Property Documentation

blur : real

The blur of the shadow. A value of 0.0 produces a sharp shadow, while larger values produce a softer, more diffuse shadow. The default value is 10.0.

color : color

The color of the shadow. The default value is transparent, which means that no shadow will be drawn by default.

See also visible and opacity.

delegate : Component

A custom QML Component that replaces the default shadow rendering. When set, StyleKit instantiates this component instead of drawing the default shadow.

horizontalOffset : real

The horizontal offset of the shadow from the delegate, in pixels.

opacity : real

The opacity of the shadow, from 0.0 (fully transparent) to 1.0 (fully opaque). The default value is 1.0.

See also visible and color.

scale : real

The scale factor of the shadow relative to the delegate. The default value is 1.0.

verticalOffset : real

The vertical offset of the shadow from the delegate, in pixels.

visible : bool

Whether the shadow is visible. The default value is true.

However, since the default shadow color is transparent, the shadow will not be visible unless a different color is set.

See also opacity.