stopImmediatePropagation method

Prevents any further propagation of an event.

Syntax

HRESULT retVal = object.stopImmediatePropagation();

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

• Document Object Model (DOM) Level 3 Events Specification, Section 4.1

Remarks

The IDOMEvent::stopImmediatePropagation method prevents any further dispatch of the event, even if additional event handlers remain on the target element. To allow the remaining handlers to run, use the IDOMEvent::stopPropagation method instead.

See also

IDOMEvent::stopPropagation