Compartilhar via


UPDATEMODE Attribute | updateMode Property

This topic documents a feature of HTML+TIME 2.0, which is obsolete as of Windows Internet Explorer 9.

Sets or gets a value that indicates how the object is to be updated.

Sets or gets a value that indicates how the object is to be updated.

Syntax

HTML <ELEMENT UPDATEMODE = sMode... >
Scripting [ sMode = ] object.updateMode

Possible Values

sMode String that specifies or receives one of the following values.
Auto
Automatically assigns a new value to the property being set and updates the object. The property maintains the repeatCount value and the segmentTime value of the element, and is similar to a reset followed by a seekTo for the object.
Reset
Default. Resets the node to its initial state after the change.

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

Remarks

updateMode was introduced in Microsoft Internet Explorer 6.

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

The following table describes which attribute or property can be updated and the effect that the updateMode property has on the atribute or property.

Attribute/Property Behavior
dur Recalculates ( recalc) the entire timing and performs a seek.
repeatCount Recalculates ( recalc) the entire timing and performs a seek.
repeatDur Recalculates ( recalc) the entire timing and performs a seek.
autoReverse Recalculates ( recalc) the entire timing and performs a seek.
speed Recalculates ( recalc) the entire timing and performs a seek.
end Updates the end value as necessary.
begin Performs the equivalent of resetElement.
restart No immediate effect. Any future begin changes or sync arc changes are affected.
fill Updates the isOn property as appropriate.

Example

The following example demonstrates how the updateMode property is used. Choose the new speed and the updateMode values, and then 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="/workshop/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>

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/behaviors/updateMode.htm

Applies To

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

See Also

Introduction to HTML+TIME