segmentTime Property (currTimeState)

HTML (DHTML)

segmentTime Property

Internet Development Index

Retrieves the current point in time along a segment of time.

Syntax

[ iTime = ] currTimeState.segmentTime

Possible Values

iTimeInteger that receives the current point in time along a segment of time, in seconds. The value of this property ranges from 0 to segmentDur.

The property is read-only. The property has no default value.

Remarks

The segmentTime property contains the time elapsed since the beginning of the current iteration through an object's timeline. This includes time spent in reverse mode. Run the example below and note how segmentTime accumulates as the timeline goes forward and backward, then starts over when the repeatCount increments.

Example

This example shows how activeTime, segmentTime, and simpleTime relate to each other.

<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
<HEAD>
<TITLE>segmentTime Example</TITLE>
<STYLE>
.time{behavior: url(#default#time2);}
</STYLE>
<?IMPORT namespace="t" implementation="#default#time2">
<SCRIPT LANGUAGE="JScript">
window.onload = fnOnLoad;
function fnOnLoad()
{
// Set up a timer to watch the time values.
window.setInterval(fnUpdateTimes, 100);
}
function fnUpdateTimes()
{
oSimpleTime.innerHTML = "&nbsp;simpleTime:&nbsp;" +
(oAnim.currTimeState.simpleTime);
oSegmentTime.innerHTML = "segmentTime:&nbsp;" +
(oAnim.currTimeState.segmentTime);
oActiveTime.innerHTML = "&nbsp;activeTime:&nbsp;" +
(oAnim.currTimeState.activeTime);
}
function fnRepeat()
{
oRepeatCount.innerHTML = "repeatCount:&nbsp;" +
(oAnim.currTimeState.repeatCount + 1);
// Add one because repeatCount is zero-based.
}
</SCRIPT>
</HEAD>
<BODY>
<DIV STYLE="font-family:courier;">
<DIV ID="oRepeatCount">repeatCount: 1</DIV>
<DIV ID="oSimpleTime">&nbsp;simpleTime:&nbsp;0</DIV>
<DIV ID="oSegmentTime">segmentTime:&nbsp;0</DIV>
<DIV ID="oActiveTime">&nbsp;activeTime:&nbsp;0</DIV>
</DIV>
<DIV ID="oDiv" CLASS="time" STYLE="position:absolute; left:50px;
top:250px; width:100px; height:100px; background-color:blue;"></DIV>
<t:ANIMATEMOTION ID="oAnim" targetElement="oDIV" to="340,40" dur="2"
autoReverse="true" repeatCount="5" onrepeat="fnRepeat()" fill="freeze"/>
</BODY>
</HTML>
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.

Standards Information

This property is a Microsoft extension to Synchronized Multimedia Integration Language (SMIL) Non-Microsoft link.

Applies To

currTimeState

See Also

activeTime, simpleTime, Introduction to HTML+TIME