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.