LOOP Attribute | loop Property

MS Office DHTML, HTML & CSS

LOOP Attribute | loop Property


Sets or retrieves the number of times a sound or video clip will loop when activated.

Syntax

HTML<ELEMENT LOOP = iLoop ... >
Scriptingobject.loop [ = iLoop ]

Possible Values

iLoopInteger that specifies one of the following values:
0, -1Loops infinitely.
countNumber of times to loop.

The property is read/write with a default value of 1.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see dynamic propertiesInternet Link.

Remarks

To restart a sound or video clip after changing its loop property, set the src property or dynsrc property, respectively, to itself (see Example). In Internet Explorer 4.0, when you restart a video by changing its loop property, the video opens and plays in a new window.

The following are descriptions of how the loop property works for some boundary cases.

<BGSOUND src="file:///c:\win95\system\msremind.wav">Loops one time
<BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP>Loops one time.
<BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=>Loops one time.
<BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=0>Loops one time.
<BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=-1>Loops infinitely.

Example

This example uses the loop property and the src property to change the number of times a background sound loops.

<SCRIPT>
function loopOnce() {
    oBGSound.loop = 1;
    oBGSound.src = oBGSound.src; // reload sound
}
function loopContinuously() {
    oBGSound.loop = -1;
    oBGSound.src = oBGSound.src; // reload sound
}
</SCRIPT>
:
<BGSOUND id="oBGSound" src="sound.wav">
<BUTTON onclick="loopOnce()">Loop Sound Once</BUTTON> 
<BUTTON onclick="loopContinuously()">Loop Sound Continuously</BUTTON>

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

Applies To

[ Object Name ]
PlatformVersion
Win16:
Win32:
Mac:
Unix:
WinCE:
Version data is listed when the mouse hovers over a link, or the link has focus.
BGSOUND, IMG

Back to topBack to top

Did you find this topic useful? Suggestions for other topics? write us!Internet Link

© 1999 microsoft corporation. all rights reserved. terms of useInternet Link.