BlendTrans Filter

This topic documents a feature of Visual Filters and Transitions, which is deprecated as of Windows Internet Explorer 9.

Reveals new content of the object by fading the original content.

Syntax

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

Possible Values

sProperties String that specifies one or more properties exposed by the filter.

Members Table

The following table lists the members exposed by the BlendTrans object.

Attribute Property Description
duration Duration

Sets or retrieves the length of time the transition takes to complete.

enabled Enabled

Sets or retrieves a value that indicates whether the filter is enabled.

Percent

Sets or retrieves the point in a transition at which to capture the display for a static filter output.

status

Retrieves the state of the transition.

Method Description
apply

Captures the initial display of an object's content for a transition.

play

Plays the transition.

stop

Stops the transition playback.

Remarks

You can create this effect more efficiently with the BasicImage filter.

The object that the filter is applied to must have layout before the filter effect will display. 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.

Example

This example uses the BlendTrans filter to fade a div element into and out of view.

<HEAD>
<SCRIPT>
function fadeOut() {
    oDiv.style.filter="blendTrans(duration=2)";
    // Make sure the filter is not playing.
    if (oDiv.filters.blendTrans.status != 2) {
        oDiv.filters.blendTrans.apply();
        oDiv.style.visibility="hidden";
        oDiv.filters.blendTrans.play();
    }
}
function fadeIn() {
    oDiv.style.filter="blendTrans(duration=2)";
    // Make sure the filter is not playing.
    if (oDiv.filters.blendTrans.status != 2) {
        oDiv.filters.blendTrans.apply();
        oDiv.style.visibility="visible";
        oDiv.filters.blendTrans.play();
    }
}
</SCRIPT>
</HEAD>

<BODY>
<!-- DIV must be assigned a width to give it layout. -->
<DIV ID="oDiv" STYLE="width: 200">
This text can be faded in and out.
</DIV>
<P>
<BUTTON onclick="fadeOut()">Fade Text Out</BUTTON> 
<BUTTON onclick="fadeIn()">Fade Text In</BUTTON>
</P>
</BODY>

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/filter/blendTrans.htm

Applies To

A, ABBR, ACRONYM, ADDRESS, B, BDO, BIG, BLOCKQUOTE, BODY, 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

Downlevel Support and Internet Explorer 4.0 Filters