UPDATEMODE Attribute | updateMode Property (t:ANIMATION, t:AUDIO, t:IMG, ...)

HTML (DHTML)

UPDATEMODE Attribute | updateMode Property

Internet Development Index

Specifies or retrieves a value that indicates how the object is to be updated.

Syntax

HTML<ELEMENT UPDATEMODE = sMode... >
Scriptingobject.updateMode [ = sMode ]

Possible Values

sModeString that specifies or receives one of the following values.
AutoAutomatically assigns a new value to the property being set and updates the object. The property maintains the repeatCount and segmentTime values of the element and is similar to resetting followed by a seekTo for the object.
ResetDefault. Resets the node to its initial state after the change.

The property is read/write. The property has a default value of Reset.

Remarks

The beginElement method called on an object with updateMode set to Reset will be ignored.

The table below describes what attribute/property can be updated and the effects that the updateMode property has on it.

Attribute/PropertyBehavior
durRecalculates (recalc) the entire timing and does a seek.
repeatCountRecalculates (recalc) the entire timing and does a seek.
repeatDurRecalculates (recalc) the entire timing and does a seek.
autoReverseRecalculates (recalc) the entire timing and does a seek.
speedRecalculates (recalc) the entire timing and does a seek.
endUpdates the end value as necessary.
beginDoes the equivalent of resetElement.
restartNo immediate effect. Any future begins or sync arc changes are affected.
fillUpdates the isOn property as appropriate.

Example

The following example demonstrates how the updateMode property is used. Choose the new speed, updateMode values, and click the "Change to new speed" button to implement the change for the MEDIA object.

<HTML xmlns:t= "urn:schemas-microsoft-com:time">
<HEAD>
<?IMPORT namespace="t" implementation="#default#time2">
<STYLE>
.time{behavior:url(#default#time2)}
</STYLE>
<SCRIPT>
function doChange(){
oMedia.updateMode = oMode.options.value;
oMedia.speed = newspeed.options.value;
}
</SCRIPT>
</HEAD>
<BODY>
<CENTER>
<t:video updateMode="reset" style="width:175px; height:150px;"
id="oMedia" src="../../common/samples/author/behaviors/media/movie.avi"/>
...
<BR>
Select <B>updateMode</B> value: <SELECT name="oMode">
<OPTION value="auto">Auto</OPTION>
<OPTION value="reset" selected>Reset</OPTION>
</SELECT>
<BR>
Enter new speed <SELECT name="newspeed">
<OPTION value="0.25">25% Playback Speed</OPTION>
<OPTION value="0.5">50% Playback Speed</OPTION>
<OPTION value="0.75">75% Playback Speed</OPTION>
<OPTION value="1" selected>100% Playback Speed (Default)</OPTION>
<OPTION value="2">200% Playback Speed</OPTION>
</SELECT><BR>
<BUTTON onClick="doChange();">Click to change to new speed</BUTTON>&nbsp;
<BUTTON onClick="document.body.beginElement()">Restart</BUTTON>
</CENTER>
</BODY>
</HTML>
This feature requires Microsoft?Internet Explorer 6 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Applies To

t:ANIMATION, t:AUDIO, t:IMG, t:MEDIA, t:REF, t:VIDEO

See Also

Introduction to HTML+TIME