onfinish event (Internet Explorer)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

onfinish event

[This documentation is preliminary and is subject to change.]

Fires when marquee looping is complete.

Syntax

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

Standards information

There are no standards that apply here.

Event information

Synchronous	No
Bubbles	No
Cancelable	No

Event handler parameters

pEvtObj [in]: Type: IHTMLEventObj

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:

HTMLAnchorEvents2
HTMLAreaEvents2
HTMLButtonElementEvents2
HTMLControlElementEvents2
HTMLDocumentEvents2
HTMLElementEvents2
HTMLFormElementEvents2
HTMLImgEvents2
HTMLFrameSiteEvents2
HTMLInputFileElementEvents2
HTMLInputImageEvents2
HTMLInputTextElementEvents2
HTMLLabelEvents2
HTMLLinkElementEvents2
HTMLMapEvents2
HTMLMarqueeElementEvents2
HTMLObjectElementEvents2
HTMLOptionButtonElementEvents2
HTMLScriptEvents2
HTMLSelectElementEvents2
HTMLStyleElementEvents2
HTMLTableEvents2
HTMLTextContainerEvents2
HTMLWindowEvents2

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


<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>