releaseCapture method

Article
06/14/2012

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

Removes mouse capture from the object in the current document.

Syntax

HRESULT retVal = object.releaseCapture();

Standards information

There are no standards that apply here.

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.

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.