org.w3c.dom.events

Интерфейсный EventTarget

public interface EventTarget

EventTarget интерфейс реализуется всеми Nodes в реализации, которая поддерживает Модель событий ДОМА. Поэтому, этот интерфейс может быть получен при использовании обязательно-специфичных методов кастинга на экземпляре Node интерфейс. Интерфейс позволяет регистрацию и удаление EventListeners на EventTarget и диспетчеризируйте событий этому EventTarget.

См. также Объектную модель документа (ДОМ) Спецификация Событий Уровня 2.

С тех пор:

ДОМ Левель 2

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addEventListener(String type, EventListener listener, boolean useCapture) Этот метод позволяет регистрацию слушателей события на цели события.
boolean	dispatchEvent(Event evt) Этот метод позволяет диспетчеризирование событий в модель событий реализаций.
void	removeEventListener(String type, EventListener listener, boolean useCapture) Этот метод позволяет удаление слушателей события от цели события.

Деталь метода

addEventListener

void addEventListener(String type,
                    EventListener listener,
                    boolean useCapture)

Этот метод позволяет регистрацию слушателей события на цели события. Если EventListener добавляется к EventTarget в то время как это обрабатывает событие, это не будет инициировано текущими действиями, но может быть инициировано во время более позднего этапа потока события, такого как пузырящаяся фаза.
Если многократный идентичный EventListeners регистрируются на том же самом EventTarget с теми же самыми параметрами отбрасываются двойные экземпляры. Они не вызывают EventListener чтобы быть вызванными дважды и так как они отбрасываются, они не должны быть удалены с removeEventListener метод.

Параметры:

type - Тип события, для которого регистрируется пользователь

listener - listener параметр берет интерфейс, реализованный пользователем, который содержит методы, которые вызовут, когда событие имеет место.

useCapture - Если это правда, useCapture указывает, что пользователь хочет инициировать получение. После инициирования получения все события указанного типа будут диспетчеризированы зарегистрированному EventListener прежде, чем быть диспетчеризированным любому EventTargets ниже их в дереве. События, которые пузырятся вверх через дерево, не инициируют EventListener определяемый, чтобы использовать получение.

removeEventListener

void removeEventListener(String type,
                       EventListener listener,
                       boolean useCapture)

Этот метод позволяет удаление слушателей события от цели события. Если EventListener удаляется из EventTarget в то время как это обрабатывает событие, это не будет инициировано текущими действиями. EventListeners никогда не может вызываться, будучи удаленным.
Вызов removeEventListener с параметрами, которые не идентифицируют, любой в настоящий момент зарегистрировался EventListener на EventTarget не имеет никакого эффекта.

Параметры:

type - Определяет тип события EventListener быть удаленным.

listener - EventListener параметр указывает EventListener быть удаленным.

useCapture - Определяет ли EventListener быть удаленным было зарегистрировано как слушатель получения или нет. Если бы слушатель был зарегистрирован дважды, один с получением и один без, то каждый должен быть удален отдельно. Удаление слушателя получения не влияет на версию неполучения того же самого слушателя, и наоборот.

dispatchEvent

boolean dispatchEvent(Event evt)
                      throws EventException

Этот метод позволяет диспетчеризирование событий в модель событий реализаций. У событий, диспетчеризированных этим способом, будут то же самое получение и пузырящееся поведение как события диспетчеризированными непосредственно реализацией. Цель события EventTarget на котором dispatchEvent вызывается.

Параметры:

evt - Определяет тип события, поведение, и контекстную информацию, которая будет использоваться в обработке события.

Возвраты:

Возвращаемое значение dispatchEvent указывает, ли любой из слушателей, которые обработали вызванное событие preventDefault. Если preventDefault был вызван значение является ложью, еще значение является истиной.

Броски:

EventException - UNSPECIFIED_EVENT_TYPE_ERR: Повышенный, если Event's тип не был определен, инициализируя событие прежде dispatchEvent был вызван. Спецификация Event's вводят как null или пустая строка также инициирует это исключение.