losecapture | onlosecapture event (Internet Explorer)

The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

5 out of 7 rated this helpful - Rate this topic

Fires when the object loses the mouse capture.

Syntax

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

Event information

Synchronous	No
Bubbles	No
Cancelable	No

Event handler parameters

pEvtObj [in]: Type: IHTMLEventObj

Standards information

There are no standards that apply here.

Remarks

Sends the event notification to the object that is losing the mouse capture.

To invoke this event, do one of the following:

Set mouse capture to a different object.
Change the active window so that the current document using mouse capture loses focus.
Invoke the releaseCapture method on the document or object.

The pEvtObj parameter is required for the following interfaces:

Examples

This example shows how to fire the onlosecapture event. When the user clicks the mouse, the releaseCapture method is invoked and subsequently fires the onlosecapture event.

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


<BODY onload="divOwnCapture.setCapture()"
    onclick="divOwnCapture.releaseCapture();">
<DIV ID=divOwnCapture
    onmousemove="txtWriteLocation.value=event.clientX 
		+ event.clientY";
    onlosecapture="alert(event.srcElement.id 
		+ ' lost mouse capture.')">
<P>Mouse capture has been set to this gray division (DIV) at
   load time using the setCapture method. The text area will track
   the mousemove event anywhere in the document.<BR><BR>
<TEXTAREA ID=txtWriteLocation COLS=2></TEXTAREA>
</DIV>
<HR>
<DIV ID=divNoCapture>
<P>Click anywhere on the document to invoke the releaseCapture 
   method, whereby the onlosecapture event will fire.</P>
</DIV>
</BODY>

losecapture | onlosecapture event