Интерфейс Event
- Все известные подинтерфейсы:
-
LSLoadEvent,LSProgressEvent,MouseEvent,MutationEvent,UIEvent
public interface Event
Интерфейс Event используется для предоставления контекстной информации о событии обработчику, обрабатывающему это событие. Объект, реализующий интерфейс Event, обычно передаётся как первый параметр обработчику событий. Более конкретная контекстная информация передаётся обработчикам событий путём получения дополнительных интерфейсов от Event, содержащих информацию, напрямую связанную с типом события, которому они соответствуют. Эти производные интерфейсы также реализуются объектом, переданным слушателю событий.
См. также Спецификацию событий модели объекта документа (DOM) уровня 2.
- С:
- 1.5, DOM Level 2
Поля
| Модификатор и тип | Поле | Описание |
|---|---|---|
static short | AT_TARGET | Событие в настоящее время оценивается в целевом |
static short | BUBBLING_PHASE | Текущая фаза события — фаза всплытия. |
static short | CAPTURING_PHASE | Текущая фаза события — фаза захвата. |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean | getBubbles() | Используется для указания, является ли событие событием всплытия. |
boolean | getCancelable() | Используется для указания, может ли быть предотвращено его действие по умолчанию. |
EventTarget | getCurrentTarget() | Используется для указания |
short | getEventPhase() | Используется для указания фазы потока событий, которая в настоящее время оценивается. |
EventTarget | getTarget() | Используется для указания |
long | getTimeStamp() | Используется для указания времени (в миллисекундах относительно эпохи), в которое событие было создано. |
String | getType() | Имя события (регистронезависимое). |
void | initEvent(String eventTypeArg,
boolean canBubbleArg,
boolean cancelableArg) | Метод |
void | preventDefault() | Если событие может быть отменено, метод |
void | 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()
Используется для указания, является ли событие событием всплытия. Если событие может всплывать, значение равно true, иначе — false.
getCancelable
boolean getCancelable()
Используется для указания, может ли быть предотвращено его действие по умолчанию. Если действие по умолчанию может быть предотвращено, значение равно true, иначе — false.
getTimeStamp
long getTimeStamp()
Используется для указания времени (в миллисекундах относительно эпохи), в которое событие было создано. Поскольку некоторые системы могут не предоставлять эту информацию, значение timeStamp может быть недоступно для всех событий. В случае отсутствия доступности возвращается значение 0. Примеры эпохи — время запуска системы или 00:00:00 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. Любой новый тип события не должен начинаться с любой версии в верхнем, нижнем или смешанном регистре строки «DOM». Этот префикс зарезервирован для будущих наборов событий DOM. Также настоятельно рекомендуется, чтобы третьи стороны, добавляющие свои собственные события, использовали свой собственный префикс, чтобы избежать путаницы и уменьшить вероятность конфликтов с другими новыми событиями. -
canBubbleArg- Указывает, может ли событие всплывать. -
cancelableArg- Указывает, может ли быть предотвращено действие события по умолчанию.
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.xml/org/w3c/dom/events/Event.html
