org.w3c.dom.events

Интерфейсное Событие

Все Известные Подынтерфейсы:

LSLoadEvent, LSProgressEvent, MouseEvent, MutationEvent, UIEvent

public interface Event

Event интерфейс используется, чтобы предоставить контекстную информацию о событии к обработчику, обрабатывающему событие. Объект, который реализует Event интерфейс обычно передают как первый параметр к обработчику событий. Более определенную контекстную информацию передают к обработчикам событий, получая дополнительные интерфейсы из Event которые содержат информацию, непосредственно касающуюся типа события, они сопровождают. Эти полученные интерфейсы также реализуются объектом, который передают слушателю события.

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

С тех пор:

ДОМ Левель 2

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static short	AT_TARGET Событие в настоящий момент оценивается в цели EventTarget.
static short	BUBBLING_PHASE Текущая фаза события является пузырящейся фазой.
static short	CAPTURING_PHASE Текущая фаза события является фазой получения.

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

Методы

Модификатор и Тип	Метод и Описание
boolean	getBubbles() Используемый, чтобы указать, является ли событие пузырящимся событием.
boolean	getCancelable() Используемый, чтобы указать, можно ли событию было предотвратить его действие по умолчанию.
EventTarget	getCurrentTarget() Используемый, чтобы указать EventTarget чей EventListeners в настоящий момент обрабатываются.
short	getEventPhase() Используемый, чтобы указать, какая фаза потока события в настоящий момент оценивается.
EventTarget	getTarget() Используемый, чтобы указать EventTarget которому событие было первоначально диспетчеризировано.
long	getTimeStamp() Используемый, чтобы определить время (в миллисекундах относительно эпохи), в котором создавалось событие.
Строка	getType() Имя (нечувствительного к регистру) события.
void	initEvent(String eventTypeArg, boolean canBubbleArg, boolean cancelableArg) initEvent метод используется, чтобы инициализировать значение Event создаваемый через DocumentEvent интерфейс.
void	preventDefault() Если событие отменяемо, preventDefault метод используется, чтобы показать, что событие должно быть отменено, означая, что любые меры по умолчанию, обычно предпринимаемые реализацией в результате события, не будут происходить.
void	stopPropagation() stopPropagation метод используется, предотвращают дальнейшее распространение события во время потока события.

Полевая Деталь

CAPTURING_PHASE

static final short CAPTURING_PHASE

Текущая фаза события является фазой получения.

См. Также:

Постоянные Значения полей

AT_TARGET

static final short AT_TARGET

Событие в настоящий момент оценивается в цели EventTarget.

См. Также:

Постоянные Значения полей

BUBBLING_PHASE

static final short BUBBLING_PHASE

Текущая фаза события является пузырящейся фазой.

См. Также:

Постоянные Значения полей

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

getType

String getType()

Имя (нечувствительного к регистру) события. Имя должно быть именем XML.

getTarget

EventTarget getTarget()

Используемый, чтобы указать EventTarget которому событие было первоначально диспетчеризировано.

getCurrentTarget

EventTarget getCurrentTarget()

Используемый, чтобы указать EventTarget чей EventListeners в настоящий момент обрабатываются. Это особенно полезно во время получения и пузырения.

getEventPhase

short getEventPhase()

Используемый, чтобы указать, какая фаза потока события в настоящий момент оценивается.

getBubbles

boolean getBubbles()

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

getCancelable

boolean getCancelable()

Используемый, чтобы указать, можно ли событию было предотвратить его действие по умолчанию. Если действие по умолчанию может быть предотвращено, значение является истиной, еще значение является ложью.

getTimeStamp

long getTimeStamp()

Используемый, чтобы определить время (в миллисекундах относительно эпохи), в котором создавалось событие. Вследствие того, что некоторые системы, возможно, не предоставляют эту информацию значение timeStamp может быть не доступным для всех событий. Если не доступный, значение 0 будет возвращено. Примерами времени эпохи является время системы, запускаются или 0:0:0 UTC 1-ого января 1970.

stopPropagation

void stopPropagation()

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

preventDefault

void preventDefault()

Если событие отменяемо, preventDefault метод используется, чтобы показать, что событие должно быть отменено, означая, что любые меры по умолчанию, обычно предпринимаемые реализацией в результате события, не будут происходить. Если, во время любого этапа потока события, preventDefault метод вызывают, событие отменяется. Любое действие по умолчанию, связанное с событием, не будет происходить. Вызов этого метода для неотменяемого события не имеет никакого эффекта. Однажды preventDefault был вызван это останется в силе всюду по остатку от распространения события. Этот метод может использоваться во время любого этапа потока события.

initEvent

void initEvent(String eventTypeArg,
             boolean canBubbleArg,
             boolean cancelableArg)

initEvent метод используется, чтобы инициализировать значение Event создаваемый через DocumentEvent интерфейс. Этот метод можно только вызвать перед Event был диспетчеризирован через dispatchEvent метод, хотя это можно вызвать многократно во время той фазы в случае необходимости. Если вызвано многократно заключительный вызов имеет приоритет. Если вызвано от подкласса Event соедините интерфейсом только со значениями, определенными в initEvent метод изменяется, все другие атрибуты оставляют неизменными.

Параметры:

eventTypeArg - Определяет тип события. Этот тип может быть любым типом события, в настоящий момент определенным в этой спецификации или новом типе события.. Строка должна быть именем XML. Любой новый тип события не должен начаться ни с кого верхнего, ниже, или смешанная версия случая строки "ДОМ". Этот префикс резервируется для будущего наборы события ДОМА. Также строго рекомендуется, чтобы третьи стороны, добавляющие их собственные события, использовали свой собственный префикс, чтобы избежать беспорядка и уменьшить вероятность конфликтов с другими новыми событиями.

canBubbleArg - Определяет, может ли событие пузыриться.

cancelableArg - Определяет, может ли действие события по умолчанию быть предотвращено.