IEventTarget.AddEventListener

AddEventListener(string, IEventListener)

The EventTarget method addEventListener() sets up a function that will be called whenever the specified event is delivered to the target.

Common targets are Element, Document, and Window, but the target may be any object that supports events (such as XMLHttpRequest).

public void AddEventListener(string type, IEventListener listener)
ParameterTypeDescription
typeStringA case-sensitive string representing the event type to listen for.
listenerIEventListenerTakes an interface implemented by the user which contains the methods to be called when the event occurs.

Remarks

If an is added to an while it is processing an event, it will not be triggered by the current actions but may be triggered during a later stage of event flow, such as the bubbling phase. If multiple identical Event Listeners are registered on the same with the same parameters the duplicate instances are discarded. They do not cause the to be called twice and since they are discarded they do not need to be removed with the method.

See Also


AddEventListener(string, IEventListener, bool)

The EventTarget method addEventListener() sets up a function that will be called whenever the specified event is delivered to the target.

Common targets are Element, Document, and Window, but the target may be any object that supports events (such as XMLHttpRequest).

public void AddEventListener(string type, IEventListener listener, bool useCapture)
ParameterTypeDescription
typeStringA case-sensitive string representing the event type to listen for.
listenerIEventListenerTakes an interface implemented by the user which contains the methods to be called when the event occurs.
useCaptureBooleanIf true, useCapture indicates that the user wishes to initiate capture. After initiating capture, all events of the specified type will be dispatched to the registered before being dispatched to any Event Targets beneath them in the tree. Events which are bubbling upward through the tree will not trigger an designated to use capture.

Remarks

If an is added to an while it is processing an event, it will not be triggered by the current actions but may be triggered during a later stage of event flow, such as the bubbling phase. If multiple identical Event Listeners are registered on the same with the same parameters the duplicate instances are discarded. They do not cause the to be called twice and since they are discarded they do not need to be removed with the method.

See Also