loop property

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

Syntax

HRESULT value = object.put_loop( loop);HRESULT value = object.get_loop(* loop);

Property values

Type: VARIANT

-1

Loops infinitely.

0

Loops one time.

count

Number of times to loop.

Value Condition
1

Default. Loops once.

Remarks

To restart a sound or video clip after changing its IHTMLBGsound::loop property, set the IHTMLBGsound::src property or IHTMLImgElement3::dynsrc property to itself. For example:

oBGSound.src = oBGSound.src

The following are descriptions of how the IHTMLBGsound::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.