progressBehavior Property

Retrieves an object indicating the progress of the specified Microsoft® DirectAnimation® behavior.

Syntax

Scripting [ oProgress = ] object.progressBehavior

Scripting	[ oProgress = ] object.progressBehavior

Possible Values

oProgress Object that specifies the DirectAnimation number (DANumber ) used to indicate the progress of the behavior. The DANumber object contains a floating-point number, with a value between 0.0 and 1.0, that indicates how much of the behavior is complete.

The property is read-only with no default value.

Remarks

This property allows you to incorporate multimedia elements, such as 2-D and 3-D animated images and sounds, into an HTML page with the anim:DA element. The object this property is applied to must be an HTML object with a valid HTML+TIME timeline. Use this property with HTML+TIME timelines to control DirectAnimation content. This property is not part of the HTML+TIME specification.

Important To ensure that pages using this property display properly in future versions of Internet Explorer, complete the following steps:

Use "#time" instead of "#default#time" for the behavior declaration.

Include the time object in your page. The class identifier used to specify this object is 476C391C-3E0D-11D2-B948-00C04FA32195.

These actions are necessary only for pages that use HTML+TIME timelines to control DirectAnimation content.

Example

This example attaches a timeline specified with HTML+TIME to an image animated with DirectAnimation. The progressBehavior property is used to animate the opacity of the image.

Sample Code

<HTML>
<HEAD> 
<TITLE>progressBehavior</TITLE>
<XML:NAMESPACE PREFIX="anim"/>
<STYLE>
.time       { behavior: url(#time); }
anim\:DA    { behavior: url(#default#anim); }
</STYLE>
<OBJECT ID="time" CLASSID="CLSID:476C391C-3E0D-11D2-B948-00C04FA32195">
</OBJECT>
</HEAD>

<BODY>
<P>In two seconds, the image will fades until it disappears after five 
seconds of animation. This process repeats itself three times.</P>
<SPAN ID="spanImg" CLASS="time" t:TIMEACTION="visibility" t:BEGIN="2"
t:DUR="5" t:REPEAT="3">
</SPAN>
<DIV ALIGN="center">
    <anim:DA ID="da1" STYLE="width:504; height:126; z-index: -1;" />
</DIV>
<BR>
<BUTTON onclick="spanImg.beginElement();">Restart</BUTTON>

<SCRIPT LANGUAGE="JScript">
<!--
   // Assign a variable to the DA statics library
   m = da1.statics;
   // Create a DAImage
   img1 = m.ImportImage("/workshop/graphics/solarsys.gif");   
   // Animate the opacity of the image from 100% to 0%, based 
   // on the progress of the time behavior. Use (1 - progress) 
   // to get the proper opacity.
   img2 = img1.OpacityAnim(m.Sub(m.DANumber(1),spanImg.progressBehavior));  
   // Set the image do be displayed 
   da1.image = img2;     
//-->  
</SCRIPT>
</BODY>
</HTML>

This feature requires Internet Explorer 5 or later. Click the icon below to install the latest version. Then reload this page to view the sample.

Applies To

[ Object Name ]

Platform Version

Win16:

Win32:

Mac:

Unix:

WinCE:

Version data is listed when the mouse hovers over a link, or the link has focus.

time