strength Attribute | Strength

HTML (DHTML)

strength Attribute | Strength Property

Internet Development Index

Sets or retrieves the distance, in pixels, that a filter effect extends.

Syntax

HTML
{ filter:progid:DXImageTransform.Microsoft.filter-name(
    strength = iDistance ... ) ... }
Scripting
object.filters.item(
    "DXImageTransform.Microsoft.filter-name").Strength [ = iDistance ]

Possible Values

iDistanceInteger that specifies or receives the distance, in pixels, that an effect extends.
5Default.

The property is read/write. The property has a default value of 5 for all objects with the following exceptions:

Wave1
Shadow1

Remarks

The following table defines the limitations on the range of iDistance depending on the filter used.

FilterAllowable Range
MotionBlurzero or greater
Glowone to 255
Shadowone to 255
Waveone or greater

Example

This example sets the Strength and Direction properties of the MotionBlur filter to an initial strength of 1. When the page loads, the Strength and Direction properties cause the onfilterchange event to fire repeatedly until the strength reaches 200.

<SCRIPT>
function HandleChange()
{
with (window.event.srcElement.filters[0])
{
if (strength < 200)
{
strength += 1;
direction += 45;
}
}
}</SCRIPT>
<IMG ID="img1" SRC="solarsys.gif" onfilterchange="HandleChange()"
STYLE="filter:progid:DXImageTransform.Microsoft.motionBlur(STRENGTH=1, DIRECTION=0)" />
This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Applies To

MotionBlur, Glow, Wave, Shadow