Интерфейс MouseEvent

Все суперинтерфейсы:: Event, UIEvent

public interface MouseEvent extends UIEvent

Интерфейс MouseEvent предоставляет конкретную контекстную информацию, связанную с событиями мыши.

Атрибут detail, унаследованный от UIEvent, указывает, сколько раз кнопка мыши была нажата и отпущена в одном и том же месте экрана в ходе действия пользователя. Значение атрибута равно 1, когда пользователь начинает это действие, и увеличивается на 1 после каждого полного цикла нажатия и отпускания. Если пользователь перемещает мышь между событиями mousedown и mouseup, значение будет установлено в 0, что указывает на отсутствие щелчка.

В случае вложенных элементов события мыши всегда направляются наиболее глубоко вложенному элементу. Предки целевого элемента могут использовать всплытие, чтобы получать уведомления о событиях мыши, происходящих во вложенных дочерних элементах.

См. также Спецификацию модели объектного документа (DOM) уровня 2: события.

Начиная с:: 1.5, DOM уровня 2

Краткое описание полей

Поля, объявленные в интерфейсе Event

AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE

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

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`getAltKey()`	Используется для определения того, была ли нажата клавиша 'alt' во время возникновения события.
`short`	`getButton()`	При событиях мыши, вызванных нажатием или отпусканием кнопки мыши, `button` используется для определения того, какая кнопка мыши изменила состояние.
`int`	`getClientX()`	Горизонтальная координата, в которой произошло событие, относительно клиентской области реализации DOM.
`int`	`getClientY()`	Вертикальная координата, в которой произошло событие, относительно клиентской области реализации DOM.
`boolean`	`getCtrlKey()`	Используется для определения того, была ли нажата клавиша 'ctrl' во время возникновения события.
`boolean`	`getMetaKey()`	Используется для определения того, была ли нажата клавиша 'meta' во время возникновения события.
`EventTarget`	`getRelatedTarget()`	Используется для определения вторичного `EventTarget`, связанного с событием пользовательского интерфейса.
`int`	`getScreenX()`	Горизонтальная координата, в которой произошло событие, относительно начала системы экранных координат.
`int`	`getScreenY()`	Вертикальная координата, в которой произошло событие, относительно начала системы экранных координат.
`boolean`	`getShiftKey()`	Используется для определения того, была ли нажата клавиша 'shift' во время возникновения события.
`void`	`initMouseEvent(String typeArg, boolean canBubbleArg, boolean cancelableArg, AbstractView viewArg, int detailArg, int screenXArg, int screenYArg, int clientXArg, int clientYArg, boolean ctrlKeyArg, boolean altKeyArg, boolean shiftKeyArg, boolean metaKeyArg, short buttonArg, EventTarget relatedTargetArg)`	Метод `initMouseEvent` используется для инициализации значения `MouseEvent`, созданного с помощью интерфейса `DocumentEvent`.

Методы, объявленные в интерфейсе Event

getBubbles, getCancelable, getCurrentTarget, getEventPhase, getTarget, getTimeStamp, getType, initEvent, preventDefault, stopPropagation

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

Методы, объявленные в интерфейсе UIEvent

getDetail, getView, initUIEvent

Модификатор и тип	Метод	Описание
`int`	`getDetail()`	Указывает некоторые дополнительные сведения о `Event` в зависимости от типа события.
`AbstractView`	`getView()`	Атрибут `view` указывает `AbstractView`, из которого было создано событие.
`void`	`initUIEvent(String typeArg, boolean canBubbleArg, boolean cancelableArg, AbstractView viewArg, int detailArg)`	Метод `initUIEvent` используется для инициализации значения `UIEvent`, созданного с помощью интерфейса `DocumentEvent`.

Подробное описание методов

getScreenX

int getScreenX()

Горизонтальная координата, в которой произошло событие, относительно начала системы экранных координат.

getScreenY

int getScreenY()

Вертикальная координата, в которой произошло событие, относительно начала системы экранных координат.

getClientX

int getClientX()

Горизонтальная координата, в которой произошло событие, относительно клиентской области реализации DOM.

getClientY

int getClientY()

Вертикальная координата, в которой произошло событие, относительно клиентской области реализации DOM.

getCtrlKey

boolean getCtrlKey()

Используется для определения того, была ли нажата клавиша 'ctrl' во время возникновения события.

getShiftKey

boolean getShiftKey()

Используется для определения того, была ли нажата клавиша 'shift' во время возникновения события.

getAltKey

boolean getAltKey()

Используется для определения того, была ли нажата клавиша 'alt' во время возникновения события. На некоторых платформах эта клавиша может соответствовать клавише с другим названием.

getMetaKey

boolean getMetaKey()

Используется для определения того, была ли нажата клавиша 'meta' во время возникновения события. На некоторых платформах эта клавиша может соответствовать клавише с другим названием.

getButton

short getButton()

При событиях мыши, вызванных нажатием или отпусканием кнопки мыши, button используется для определения того, какая кнопка мыши изменила состояние. Значения button находятся в диапазоне от нуля (левая кнопка мыши), единицы (средняя кнопка, если она есть) до двух (правая кнопка). Для мышей, настроенных для левшей, у которых действия кнопок поменяны местами, значения считываются справа налево.

getRelatedTarget

EventTarget getRelatedTarget()

Используется для определения вторичного EventTarget, связанного с событием пользовательского интерфейса. В настоящее время этот атрибут используется с событием mouseover для указания EventTarget, из которого вышло указывающее устройство, и с событием mouseout для указания EventTarget, в который вошло указывающее устройство.

initMouseEvent

void initMouseEvent(String typeArg, boolean canBubbleArg, boolean cancelableArg, AbstractView viewArg, int detailArg, int screenXArg, int screenYArg, int clientXArg, int clientYArg, boolean ctrlKeyArg, boolean altKeyArg, boolean shiftKeyArg, boolean metaKeyArg, short buttonArg, EventTarget relatedTargetArg)

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

Параметры:: typeArg — задает тип события.; canBubbleArg — указывает, может ли событие всплывать.; cancelableArg — указывает, можно ли предотвратить действие события по умолчанию.; viewArg — задает Event's AbstractView.; detailArg — задает количество щелчков мышью для Event.; screenXArg — задает координату x на экране для Event; screenYArg — задает координату y на экране для Event; clientXArg — задает координату x в клиентской области для Event; clientYArg — задает координату y в клиентской области для Event; ctrlKeyArg — указывает, была ли нажата клавиша control во время Event.; altKeyArg — указывает, была ли нажата клавиша alt во время Event.; shiftKeyArg — указывает, была ли нажата клавиша shift во время Event.; metaKeyArg — указывает, была ли нажата клавиша meta во время Event.; buttonArg — задает кнопку мыши для Event.; relatedTargetArg — задает связанный EventTarget для Event.

© 1993, 2025, 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.