DropShadow

HTML (DHTML)

DropShadow Filter

Internet Development Index

Creates a solid silhouette of the content of the object, offset in the specified direction. This creates the illusion that the content is floating and casting a shadow.

Syntax

HTML
<ELEMENT STYLE=
"filter:progid:DXImageTransform.Microsoft.DropShadow(sProperties)"
... >
Internet Explorer 5.5 or later
Scripting
object.style.filter =
"progid:DXImageTransform.Microsoft.DropShadow(sProperties)"
Internet Explorer 5.5 or later

Possible Values

sPropertiesString that specifies one or more properties exposed by the filter.

Members Table

The following table lists the members exposed by the DropShadow object. Click a tab on the left to choose the type of member you want to view.

Attributes/Properties

AttributePropertyDescription
colorColor Sets or retrieves the value of the color applied with the filter.
enabledEnabled Sets or retrieves a value that indicates whether the filter is enabled.
offXOffX Sets or retrieves the value that the drop shadow is offset from the object along the x-axis.
offYOffY Sets or retrieves the value that the drop shadow is offset from the object along the y-axis.
positivePositive Sets or retrieves the value that indicates whether the filter creates a drop shadow from the nontransparent pixels of the object.

Remarks

To retain the usual shadow effect on a transparent object, set the Positive property to 0. This causes the drop shadow to appear outside the transparent region.

This effect is supported in Microsoft® Internet Explorer 4.0. For more information about Internet Explorer 4.0 filter behavior, see Downlevel Support and Internet Explorer 4.0 Filters.

The object that the filter is applied to must have layout before the filter effect displays. You can give the object layout by setting the height or width property, setting the position property to absolute, setting the writingMode property to tb-rl, or setting the contentEditable property to true.

You can assign multiple filters or transitions to an object by declaring each in the filter property of the object. The following div declaration assigns two filters and a Wheel transition to a div element.

<DIV STYLE="width:100%; filter:
progid:DXImageTransform.Microsoft.MotionBlur(strength=13, direction=310)
progid:DXImageTransform.Microsoft.Blur(pixelradius=2)
progid:DXImageTransform.Microsoft.Wheel(duration=3);">
Blurry text with smudge of gray.</div>     
When multiple filters are applied to an object, each filter is processed in source order, with the exception of procedural surfaces, which are computed first. To emphasize a filter's effect, place it last in source order or on the object's parent. Always place transitions last in source order.

Examples

The following example shows how to change the effects of this filter by modifying its properties.

This feature requires Microsoft® Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

This example applies the DropShadow to the content of a DIV element. You can click the text of the DIV element to remove or restore the shadow.

<SCRIPT>
function fnDepress() {
var bState = oFilterDIV.filters.item('DXImageTransform.Microsoft.dropshadow').enabled;
oFilterDIV.filters.item('DXImageTransform.Microsoft.dropshadow').enabled = !bState;
}
</SCRIPT>
<DIV ID="oFilterDIV" STYLE="cursor:hand;height:160px; padding:10px; font:bold 13pt verdana;
filter:progid:DXImageTransform.Microsoft.dropshadow(OffX=5, OffY=5,
Color='gray', Positive='true')" onclick="fnDepress();">
This is the DIV content.</DIV>
This feature requires Microsoft® Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Applies To

A, ACRONYM, ADDRESS, B, BDO, BIG, BLOCKQUOTE, BUTTON, CAPTION, CENTER, CITE, CODE, CUSTOM, DD, DEL, DFN, DIR, DIV, DL, DT, EM, FIELDSET, FONT, FORM, FRAME, hn, I, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LEGEND, LI, MARQUEE, MENU, NOBR, OL, OBJECT, P, PLAINTEXT, PRE, Q, RT, RUBY, runtimeStyle, S, SAMP, SMALL, SPAN, STRIKE, STRONG, style, SUB, SUP, TABLE, TD, TEXTAREA, TH, TT, U, UL, VAR, XMP

See Also

Scripting Filters, Filter Design Considerations