stopPropagation method
[This documentation is preliminary and is subject to change.]
Prevents propagation of an event beyond the current target.
![]() ![]() |
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
Build date: 1/23/2012
.png)
.png)