finish | onfinish event

Fires when marquee looping is complete.

Syntax

HTML Attribute	<element onfinish = "handler(event)">
Event Property	object.onfinish = handler;
attachEvent Method	object.attachEvent("onfinish", handler)
addEventListener Method	object.addEventListener("finish", handler, useCapture)

Event information

Synchronous	No
Bubbles	No
Cancelable	Yes

Event handler parameters

pEvtObj [in]: Type: IHTMLEventObj

Standards information

There are no standards that apply here.

Remarks

A value greater than 1 and less than infinity must be set on the LOOP attribute for this event to fire.

Marquee ceases to loop.

To invoke this event, do one of the following:

Specify a value for the LOOP attribute of the marquee object.

The pEvtObj parameter is required for the following interfaces:

Examples

The example uses the srcElement property of the event object to determine which marquee has fired the onfinish event.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/onfinishEX.htm

JavaScript


<body>
<label>mqLooper1</label>
<marquee id="mqLooper1" loop="2" 
    onfinish="alert(event.srcElement.id + ' finished looping.')"> 
this marquee loops twice </marquee> 
<hr>
<label>mqLooper2</label>
<marquee id="mqLooper2" loop="5" 
onfinish="alert(event.srcElement.id + ' finished looping.')"> 
this marquee loops five times </marquee>
</body>