eventPhase property

Gets the event phase that is being evaluated.

 

Syntax

HRESULT value = object.get_eventPhase(* p);

Property values

Type: unsigned short

CAPTURING_PHASE (1)

The event is in the capturing phase.

AT_TARGET (2)

The event is being evaluated at the target element.

BUBBLING_PHASE (3)

The event is in the bubbling phase.

Standards information

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

Remarks

During the capturing phase, events are dispatched to parent elements before objects that are lower in the hierarchy. Next, during the bubbling phase, events are dispatched to target elements followed by parent objects. The event phase is AT_TARGET when the element that receives the event (IDOMEvent::target) is the same element as the element that is processing the event (IDOMEvent::currentTarget). The target element receives both capture and bubble events if both are registered.