boxShadow property

[This documentation is preliminary and is subject to change.]

Sets or retrieves a comma-separated list of shadows that attaches one or more drop shadows to the current box.

CSS Backgrounds and Borders Module Level 3, Section 6.2Internet Explorer 9


Integer value = object.put_boxShadow(BSTR v);Integer value = object.get_boxShadow(BSTR* sShadow);

Property values

Type: BSTR

none (none)

Default. Indicates there is no shadow.

shadow (shadow)

A comma-separated list of shadows, each specified by two to four nonzero length values, an optional color, and an optional inset keyword. See Remarks for specific information about usage.

String format

none | <shadow>

CSS information

Applies To All elements
Media visual
Inherited no
Initial Value

Standards information


The box-shadow property can specify one or more drop shadows. The components of each shadow are interpreted as follows:

  • Required: The first length is the horizontal offset of the shadow. A positive value draws a shadow that is offset to the right of the box, a negative length to the left.
  • Required: The second length is the vertical offset. A positive value offsets the shadow down, a negative one up.
  • Optional: The third length is a blur distance. Negative values are not allowed. If the blur value is zero, the shadow's edge is sharp. Otherwise, the larger the value, the more the shadow's edge is blurred.
  • Optional: The fourth length is a spread distance. Positive values cause the shadow shape to expand in all directions by the specified radius. Negative values cause the shadow shape to contract.
  • Optional: The color is the color of the shadow.
  • Optional: An inset keyword, if present, changes the drop shadow from an outer shadow (one that shadows the box onto the canvas, as if it were lifted above the canvas) to an inner shadow (one that shadows the canvas onto the box, as if the box were cut out of the canvas and shifted behind it).


Minimum supported client

Windows Vista with SP1, Windows 7

Minimum supported server

Windows Server 2008 R2









Build date: 1/23/2012