stopPropagation method

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

Prevents propagation of an event beyond the current target.

Document Object Model (DOM) Level 3 Events Specification, Section 4.1Internet Explorer 9

Syntax

HRESULT retVal = object.stopPropagation();

Standards information

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

You can stop event propagation in the capturing or bubbling event phase by calling the stopPropagation method. However, the event dispatchs to all event listeners on the current target (regardless of capturing or bubbling) before the event flow stops. To completely prevent any remaining handlers from running, use the stopImmediatePropagation method instead.

The stopPropagation method is similar to the cancelBubble event property of Windows Internet Explorer 8 and earlier versions.

See also

Reference

eventPhase

stopImmediatePropagation

 

 

Build date: 1/23/2012