Contents Index Topic Contents
	Previous Topic: IHTMLEventObj::put_cancelBubble Next Topic: IHTMLEventObj::get_fromElement

IHTMLEventObj::get_cancelBubble

HRESULT get_cancelBubble(
    VARIANT_BOOL *p
);

Retrieves whether the current event should bubble up the hierarchy of event handlers.

• Returns S_OK if successful, or an error value otherwise.

p

Address of a Boolean variable that receives TRUE if bubbling has been canceled, or FALSE otherwise.

Using this property to cancel bubbling for an event does not affect subsequent events.

See also put_cancelBubble

 Top of Page

---

IHTMLEventObj::put_cancelBubble

HRESULT put_cancelBubble(
    VARIANT_BOOL v
);

Sets whether the current event should bubble up the hierarchy of event handlers.

• Returns S_OK if successful, or an error value otherwise.

v

Boolean value that contains the cancel-bubble flag. TRUE cancels bubbling for this event, preventing the next event handler in the hierarchy from receiving the event. FALSE enables bubbling; this is the default value.

Using this property to cancel bubbling for an event does not affect subsequent events.

See also get_cancelBubble

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.