Интерфейс MouseEvent

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

public interface MouseEvent extends UIEvent

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

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

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

См. также спецификацию событий Document Object Model (DOM) Level 2.

Начиная с:: 1.5, DOM Level 2

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

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

AT_TARGET, BUBBLING_PHASE, 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

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

getDetail, getView, initUIEvent

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

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 — задает связанный Event для EventTarget.

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/events/MouseEvent.html