releaseCapture method (Windows)

This topic has not yet been rated - Rate this topic

Removes mouse capture from the object in the current document.

Syntax

object.releaseCapture()

Parameters

This method has no parameters.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Standards information

There are no standards that apply here.

Remarks

For releaseCapture to have an effect, you must set mouse capture through the setCapture method.

You can invoke the releaseCapture method on the document object. The releaseCapture method makes it unnecessary to determine which element has capture to programmatically release it. Other actions that release document capture include displaying a modal dialog box and switching focus to another application or browser window.

Examples

This example invokes the releaseCapture method on the document object.


<BODY onload="oOwnCapture.setCapture();" 
    onclick="document.releaseCapture();">
<DIV ID=oOwnCapture
    onmousemove="oWriteLocation.value = 
        event.clientX + event.clientY";
    onlosecapture="console.log(event.srcElement.id + 
        ' has lost mouse capture.')">
<TEXTAREA ID=oWriteLocation COLS=2></TEXTAREA>
</DIV>
<HR>
<DIV ID=oNoCapture>
<P>Click the document to invoke the releaseCapture method.</P>
</DIV>
</BODY>

releaseCapture method