Класс MouseEvent

javafx.scene.input.MouseEvent

Все реализованные интерфейсы:: Serializable, Cloneable

Прямые известные подклассы:: MouseDragEvent

public class MouseEvent
extends InputEvent

Когда происходит событие мыши, узел, находящийся поверх курсора, выбирается, и событие доставляется ему через фазы захвата и распространения, описанные в EventDispatcher.

Координаты мыши (указателя) доступны относительно нескольких систем координат: x, y — относительно начала координат узла MouseEvent, sceneX, sceneY — относительно начала координат Scene, содержащего узел, screenX, screenY — относительно начала координат экрана, содержащего указатель мыши.

Жесты перетаскивания

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

Жест «нажатие-перетаскивание-отпускание» по умолчанию. Он лучше всего подходит для изменения размера фигуры, перетаскивания и т. д. Весь жест «нажатие-перетаскивание-отпускание» доставляется одному узлу. Когда нажимается кнопка мыши, выбирается самый верхний узел, и все последующие события мыши доставляются этому же узлу до тех пор, пока кнопка не будет отпущена. Если из этих событий генерируется событие щелчка мыши, оно все равно доставляется тому же узлу.

Во время простого жеста «нажатие-перетаскивание-отпускание» другие узлы не вовлечены и не получают никаких событий. Если эти узлы должны быть вовлечены в жест, должен быть активирован полный жест «нажатие-перетаскивание-отпускание». Этот жест лучше всего подходит для подключения узлов «проводами», перетаскивания узлов к другим узлам и т. д. Этот тип жеста более подробно описан в MouseDragEvent, который содержит события, доставляемые целевым узлам жеста.

Третий тип жеста — это поддерживаемый платформой жест перетаскивания и перекладывания. Он лучше всего подходит для передачи данных и работает также между (не обязательно FX) приложениями. Этот тип жеста более подробно описан в DragEvent.

Вкратце, простой жест «нажатие-перетаскивание-отпускание» активируется автоматически при нажатии кнопки мыши и доставляет все MouseEvent исходному узлу жеста. Когда вы начинаете перетаскивание, в конечном итоге приходит событие DRAG_DETECTED. В обработчике вы можете либо начать полный жест «нажатие-перетаскивание-отпускание», вызвав метод startFullDrag на узле или сцене — MouseDragEvent начинают доставляться целевым узлам жеста, либо вы можете начать жест перетаскивания и перекладывания, вызвав метод startDragAndDrop на узле или сцене — система переключается в режим перетаскивания и перекладывания, и DragEvent начинают доставляться вместо MouseEvent. Если вы не вызываете ни один из этих методов, простой жест «нажатие-перетаскивание-отпускание» продолжается.

Обратите внимание, что перетаскивание пальца по сенсорному экрану создает события перетаскивания мыши, но также и события прокрутки. Если это означает конфликт в приложении (физическое действие перетаскивания обрабатывается двумя разными обработчиками), метод isSynthesized() может быть использован для обнаружения проблемы и настройки поведения обработчиков перетаскивания соответственно.

Обработка входа/выхода мыши

Когда мышь входит в узел, узел получает событие MOUSE_ENTERED, когда она выходит, он получает событие MOUSE_EXITED. Эти события доставляются только вошедшему/вышедшему узлу и, по-видимому, не проходят через фазы захвата/распространения. Это наиболее распространенный случай использования.

Если требуется захват или распространение, существуют события MOUSE_ENTERED_TARGET/MOUSE_EXITED_TARGET. Эти события проходят через фазы захвата/распространения обычно. Это означает, что родительский элемент может получить событие MOUSE_ENTERED_TARGET, когда мышь вошла либо в сам родительский элемент, либо в некоторые из его дочерних элементов. Чтобы отличить эти два случая, можно проверить целевой элемент события на равенство с узлом.

Эти два типа тесно связаны: MOUSE_ENTERED/MOUSE_EXITED являются подтипами MOUSE_ENTERED_TARGET/MOUSE_EXITED_TARGET. Во время фазы захвата MOUSE_ENTERED_TARGET доставляется родителям. Когда событие доставляется целевому элементу (узлу, который фактически был введен), его тип меняется на MOUSE_ENTERED. Затем тип возвращается к MOUSE_ENTERED_TARGET для фазы распространения. Это все еще одно событие, просто меняющее типы, поэтому если оно отфильтровывается или потребляется, это влияет на оба варианта события. Благодаря связи подтипов обработчик события MOUSE_ENTERED_TARGET получит событие MOUSE_ENTERED на целевом элементе.

Примечания

Для запуска контекстных меню см. ContextMenuEvent.

С момента:: JavaFX 2.0
См. также:: Сериализованная форма

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

Поля
Модификатор и тип	Поле	Описание
`static EventType<MouseEvent>`	`ANY`	Общий супертип для всех типов событий мыши.
`static EventType<MouseEvent>`	`DRAG_DETECTED`	Это событие доставляется узлу, который идентифицирован как источник жеста перетаскивания.
`static EventType<MouseEvent>`	`MOUSE_CLICKED`	Это событие возникает, когда кнопка мыши была нажата (нажата и отпущена на одном и том же узле).
`static EventType<MouseEvent>`	`MOUSE_DRAGGED`	Это событие возникает, когда мышь перемещается с нажатой кнопкой.
`static EventType<MouseEvent>`	`MOUSE_ENTERED`	Это событие возникает, когда мышь входит в узел.
`static EventType<MouseEvent>`	`MOUSE_ENTERED_TARGET`	Это событие возникает, когда мышь входит в узел.
`static EventType<MouseEvent>`	`MOUSE_EXITED`	Это событие возникает, когда мышь выходит из узла.
`static EventType<MouseEvent>`	`MOUSE_EXITED_TARGET`	Это событие возникает, когда мышь выходит из узла.
`static EventType<MouseEvent>`	`MOUSE_MOVED`	Это событие возникает, когда мышь перемещается внутри узла, и ни одна кнопка не нажата.
`static EventType<MouseEvent>`	`MOUSE_PRESSED`	Это событие возникает, когда нажимается кнопка мыши.
`static EventType<MouseEvent>`	`MOUSE_RELEASED`	Это событие возникает, когда отпускается кнопка мыши.

Поля, объявленные в классе javafx.event.Event

consumed, eventType, NULL_SOURCE_TARGET, target

Поля, объявленные в классе java.util.EventObject

source

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

Конструкторы
Конструктор	Описание
`MouseEvent(Object source, EventTarget target, EventType<? extends MouseEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean backButtonDown, boolean forwardButtonDown, boolean synthesized, boolean popupTrigger, boolean stillSincePress, PickResult pickResult)`	Создает новое событие MouseEvent.
`MouseEvent(Object source, EventTarget target, EventType<? extends MouseEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean synthesized, boolean popupTrigger, boolean stillSincePress, PickResult pickResult)`	Создает новое событие MouseEvent.
`MouseEvent(EventType<? extends MouseEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean backButtonDown, boolean forwardButtonDown, boolean synthesized, boolean popupTrigger, boolean stillSincePress, PickResult pickResult)`	Создает новое событие MouseEvent с null-значениями источника и целевого узла.
`MouseEvent(EventType<? extends MouseEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean synthesized, boolean popupTrigger, boolean stillSincePress, PickResult pickResult)`	Создает новое событие MouseEvent с null-значениями источника и целевого узла.

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

Модификатор и тип	Метод	Описание
`MouseEvent`	`copyFor(Object newSource, EventTarget newTarget)`	Копирует это событие для другого источника и целевого объекта.
`MouseEvent`	`copyFor(Object newSource, EventTarget newTarget, EventType<? extends MouseEvent> eventType)`	Создаёт копию заданного события с заданными заменёнными полями.
`static MouseDragEvent`	`copyForMouseDragEvent(MouseEvent e, Object source, EventTarget target, EventType<MouseDragEvent> type, Object gestureSource, PickResult pickResult)`	Создаёт копию этого события мыши типа MouseDragEvent.
`MouseButton`	`getButton()`	Какой, если есть, из кнопок мыши отвечает за это событие.
`int`	`getClickCount()`	Возвращает количество щелчков мыши, связанных с этим событием.
`EventType<? extends MouseEvent>`	`getEventType()`	Получает тип события этого события.
`PickResult`	`getPickResult()`	Возвращает информацию о выделении.
`double`	`getSceneX()`	Возвращает горизонтальную позицию события относительно начала координат `Scene`, содержащего источник MouseEvent.
`double`	`getSceneY()`	Возвращает вертикальную позицию события относительно начала координат `Scene`, содержащего источник MouseEvent.
`double`	`getScreenX()`	Возвращает абсолютную горизонтальную позицию события.
`double`	`getScreenY()`	Возвращает абсолютную вертикальную позицию события.
`double`	`getX()`	Горизонтальная позиция события относительно начала координат источника MouseEvent.
`double`	`getY()`	Вертикальная позиция события относительно начала координат источника MouseEvent.
`double`	`getZ()`	Позиция события в глубину относительно начала координат источника MouseEvent.
`boolean`	`isAltDown()`	Включён ли модификатор Alt в этом событии.
`boolean`	`isBackButtonDown()`	Возвращает `true`, если нажата кнопка "назад" (кнопка 4).
`boolean`	`isControlDown()`	Включён ли модификатор Control в этом событии.
`boolean`	`isDragDetect()`	Определяет, будет ли этому событию следовать событие `DRAG_DETECTED`.
`boolean`	`isForwardButtonDown()`	Возвращает `true`, если нажата кнопка "вперёд" (кнопка 5).
`boolean`	`isMetaDown()`	Включён ли модификатор Meta в этом событии.
`boolean`	`isMiddleButtonDown()`	Возвращает `true`, если нажата средняя кнопка (кнопка 2).
`boolean`	`isPopupTrigger()`	Возвращает `true`, если это событие мыши — событие вызова всплывающего меню для платформы.
`boolean`	`isPrimaryButtonDown()`	Возвращает `true`, если нажата основная кнопка (кнопка 1, обычно левая).
`boolean`	`isSecondaryButtonDown()`	Возвращает `true`, если нажата дополнительная кнопка (кнопка 3, обычно правая).
`boolean`	`isShiftDown()`	Включён ли модификатор Shift в этом событии.
`boolean`	`isShortcutDown()`	Возвращает, нажат ли модификатор сокращений платформы в этом событии.
`boolean`	`isStillSincePress()`	Указывает, находился ли курсор мыши в заданной зоной гистерезиса со времени последнего нажатия, произошедшего до этого события.
`boolean`	`isSynthesized()`	Указывает, синтезировано ли это событие с использованием сенсорного экрана вместо обычных устройств ввода мыши или трекпада.
`void`	`setDragDetect(boolean dragDetect)`	Расширяет поведение обнаружения перетаскивания.
`String`	`toString()`	Возвращает строковое представление этого объекта `MouseEvent`.

Методы, объявленные в классе javafx.event.Event

clone, consume, fireEvent, getTarget, isConsumed

Методы, объявленные в классе java.util.EventObject

getSource

Методы, объявленные в классе java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

ANY

public static final EventType<MouseEvent> ANY

Общий супертип для всех типов событий мыши.

MOUSE_PRESSED

public static final EventType<MouseEvent> MOUSE_PRESSED

Это событие происходит при нажатии кнопки мыши. Оно инициирует жесты нажатия-перетаскивания-отпускания, поэтому все последующие события мыши до отпускания кнопки будут переданы одному и тому же узлу.

MOUSE_RELEASED

public static final EventType<MouseEvent> MOUSE_RELEASED

Это событие происходит при отпускании кнопки мыши. Оно передаётся тому же узлу, где кнопка была нажата, инициировав жест нажатия-перетаскивания-отпускания.

MOUSE_CLICKED

public static final EventType<MouseEvent> MOUSE_CLICKED

Это событие происходит, когда кнопка мыши была щелкнута (нажата и отпущена на том же узле). Это событие обеспечивает поведенческие характеристики, аналогичные кнопке, для любого узла. Обратите внимание, что даже длинные перетаскивания могут генерировать событие щелчка (оно передаётся в самый верхний узел, на котором мышь была как нажата, так и отпущена).

MOUSE_ENTERED_TARGET

public static final EventType<MouseEvent> MOUSE_ENTERED_TARGET

Это событие происходит, когда курсор мыши входит в узел. Это событие типа «пузырение», которое передаётся также всем родительским узлам входящего узла (если оно не было обработано). Когда уведомления о входе курсора мыши в некоторые из дочерних узлов нежелательны, следует использовать MOUSE_ENTERED обработчик событий.

См. также:: MouseEvent for more information about mouse entered/exited handling

MOUSE_ENTERED

public static final EventType<MouseEvent> MOUSE_ENTERED

Это событие происходит, когда курсор мыши входит в узел. Этот тип события передаётся только вошедшему узлу, если родители хотят отфильтровать его или получить событие типа «пузырение», они должны использовать MOUSE_ENTERED_TARGET.

См. также:: MouseEvent for more information about mouse entered/exited handling

MOUSE_EXITED_TARGET

public static final EventType<MouseEvent> MOUSE_EXITED_TARGET

Это событие происходит, когда курсор мыши выходит из узла. Это событие типа «пузырение», которое передаётся также всем родительским узлам выходящего узла (если оно не было обработано). Когда уведомления о выходе курсора мыши из некоторых дочерних узлов нежелательны, следует использовать MOUSE_EXITED обработчик событий.

См. также:: MouseEvent for more information about mouse entered/exited handling

MOUSE_EXITED

public static final EventType<MouseEvent> MOUSE_EXITED

Это событие происходит, когда курсор мыши выходит из узла. Этот тип события передаётся только выходящему узлу, если родители хотят отфильтровать его или получить событие типа «пузырение», они должны использовать MOUSE_EXITED_TARGET.

См. также:: MouseEvent for more information about mouse entered/exited handling

MOUSE_MOVED

public static final EventType<MouseEvent> MOUSE_MOVED

Это событие происходит, когда курсор мыши перемещается внутри узла, и ни одна кнопка не нажата. Если нажата любая кнопка мыши, происходит событие MOUSE_DRAGGED.

MOUSE_DRAGGED

public static final EventType<MouseEvent> MOUSE_DRAGGED

Это событие происходит, когда курсор мыши перемещается с нажатой кнопкой. Оно передаётся тому же узлу, где кнопка была нажата, инициировав жест нажатия-перетаскивания-отпускания. Оно передаётся независимо от того, находится ли курсор мыши в пределах узла.

DRAG_DETECTED

public static final EventType<MouseEvent> DRAG_DETECTED

Это событие передаётся узлу, который идентифицируется как источник жеста перетаскивания. Обработчик этого события — единственное место, где можно инициировать полный жест нажатия-перетаскивания-отпускания или жест перетаскивания и перемещения (вызовом startFullDrag() или startDragAndDrop()). Если ни один из них не вызван, произойдёт простой жест нажатия-перетаскивания-отпускания.

Обратите внимание, что это событие генерируется на основе перетаскивания мыши, превышающего порог расстояния, специфичный для платформы. Вы можете изменить это поведение, вызвав метод setDragDetect на любом событии MOUSE_PRESSED или MOUSE_DRAGGED.

См. также:: MouseEvent for more details about simple press-drag-release gestures, MouseDragEvent for more details about full press-drag-release gestures, DragEvent for more details about drag and drop gestures

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

MouseEvent

public MouseEvent(EventType<? extends MouseEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean synthesized, boolean popupTrigger, boolean stillSincePress, PickResult pickResult)

Создаёт новое событие MouseEvent с нулевым источником и целевым объектом. Для этого события как isBackButtonDown(), так и isForwardButtonDown() вернут false.

Параметры:: eventType - Тип события.; x - Координата x относительно сцены.; y - Координата y относительно сцены.; screenX - Координата x относительно экрана.; screenY - Координата y относительно экрана.; button - Используемая кнопка мыши; clickCount - Количество нажатий; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Ctrl.; altDown - true, если нажата клавиша Alt.; metaDown - true, если нажата клавиша Meta.; primaryButtonDown - true, если нажата главная кнопка.; middleButtonDown - true, если нажата средняя кнопка.; secondaryButtonDown - true, если нажата вторая кнопка.; synthesized - если это событие было сгенерировано синтетически; popupTrigger - указывает, является ли это событие триггером всплывающего окна для текущей платформы; stillSincePress - см. isStillSincePress(); pickResult - результат выбора. Может быть null, в этом случае строится 2D результат выбора без дополнительных значений на основе координат сцены
С момента:: JavaFX 8.0

MouseEvent

public MouseEvent(EventType<? extends MouseEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean backButtonDown, boolean forwardButtonDown, boolean synthesized, boolean popupTrigger, boolean stillSincePress, PickResult pickResult)

Создаёт новое событие MouseEvent с нулевым источником и целевым объектом.

Параметры:: eventType - Тип события.; x - Координата x относительно сцены.; y - Координата y относительно сцены.; screenX - Координата x относительно экрана.; screenY - Координата y относительно экрана.; button - Используемая кнопка мыши; clickCount - Количество нажатий; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Ctrl.; altDown - true, если нажата клавиша Alt.; metaDown - true, если нажата клавиша Meta.; primaryButtonDown - true, если нажата главная кнопка.; middleButtonDown - true, если нажата средняя кнопка.; secondaryButtonDown - true, если нажата вторая кнопка.; backButtonDown - true, если нажата кнопка назад.; forwardButtonDown - true, если нажата кнопка вперёд; synthesized - если это событие было сгенерировано синтетически; popupTrigger - указывает, является ли это событие триггером всплывающего окна для текущей платформы; stillSincePress - см. isStillSincePress(); pickResult - результат выбора. Может быть null, в этом случае строится 2D результат выбора без дополнительных значений на основе координат сцены
С момента:: 12

MouseEvent

public MouseEvent(Object source, EventTarget target, EventType<? extends MouseEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean synthesized, boolean popupTrigger, boolean stillSincePress, PickResult pickResult)

Создаёт новое событие MouseEvent. Для этого события как isBackButtonDown(), так и isForwardButtonDown() вернут false.

Параметры:: source - Источник события. Может быть null.; target - Целевой объект события. Может быть null.; eventType - Тип события.; x - Координата x относительно источника. Должна быть в координатах сцены, если source == null или source не является узлом.; y - Координата y относительно источника. Должна быть в координатах сцены, если source == null или source не является узлом.; screenX - Координата x относительно экрана.; screenY - Координата y относительно экрана.; button - Используемая кнопка мыши; clickCount - Количество нажатий; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Ctrl.; altDown - true, если нажата клавиша Alt.; metaDown - true, если нажата клавиша Meta.; primaryButtonDown - true, если нажата главная кнопка.; middleButtonDown - true, если нажата средняя кнопка.; secondaryButtonDown - true, если нажата вторая кнопка.; synthesized - если это событие было сгенерировано синтетически; popupTrigger - указывает, является ли это событие триггером всплывающего окна для текущей платформы; stillSincePress - см. isStillSincePress(); pickResult - результат выбора. Может быть null, в этом случае строится 2D результат выбора на основе координат сцены и целевого объекта
С момента:: JavaFX 8.0

MouseEvent

public MouseEvent(Object source, EventTarget target, EventType<? extends MouseEvent> eventType, double x, double y, double screenX, double screenY, MouseButton button, int clickCount, boolean shiftDown, boolean controlDown, boolean altDown, boolean metaDown, boolean primaryButtonDown, boolean middleButtonDown, boolean secondaryButtonDown, boolean backButtonDown, boolean forwardButtonDown, boolean synthesized, boolean popupTrigger, boolean stillSincePress, PickResult pickResult)

Создаёт новый объект события MouseEvent.

Parameters:: source - источник события. Может быть null.; target - целевой объект события. Может быть null.; eventType - тип события.; x - Координата X относительно источника. Должна быть в координатах сцены, если source == null или source не является узлом.; y - Координата Y относительно источника. Должна быть в координатах сцены, если source == null или source не является узлом.; screenX - Координата X относительно экрана.; screenY - Координата Y относительно экрана.; button - использованная кнопка мыши; clickCount - количество нажатий; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Control.; altDown - true, если нажата клавиша Alt.; metaDown - true, если нажата клавиша Meta.; primaryButtonDown - true, если нажата основная кнопка.; middleButtonDown - true, если нажата средняя кнопка.; secondaryButtonDown - true, если нажата вторичная кнопка.; forwardButtonDown - true, если нажата кнопка вперёд.; backButtonDown - true, если нажата кнопка назад; synthesized - если событие было синтезировано; popupTrigger - указывает, является ли это событие триггером всплывающего меню для текущей платформы; stillSincePress - см. isStillSincePress(); pickResult - результат выбора. Может быть null, в этом случае результат 2D-выбора создаётся на основе координат сцены и целевого объекта
Since:: 12

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

getEventType

public EventType<? extends MouseEvent> getEventType()

Описание скопировано из класса: Event

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

Overrides:: getEventType в классе Event
Returns:: тип события

copyFor

public MouseEvent copyFor(Object newSource, EventTarget newTarget)

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

Overrides:: copyFor в классе Event
Parameters:: newSource - новый источник события; newTarget - новый целевой объект события
Returns:: копия события для другого источника и целевого объекта

copyFor

public MouseEvent copyFor(Object newSource, EventTarget newTarget, EventType<? extends MouseEvent> eventType)

Создаёт копию события с подставленными значениями.

Parameters:: newSource - новый источник скопированного события; newTarget - новый целевой объект скопированного события; eventType - новый тип события
Returns:: копия события с подставленными полями
Since:: JavaFX 8.0

copyForMouseDragEvent

public static MouseDragEvent copyForMouseDragEvent(MouseEvent e, Object source, EventTarget target, EventType<MouseDragEvent> type, Object gestureSource, PickResult pickResult)

Создаёт копию события MouseEvent типа MouseDragEvent.

Parameters:: e - событие мыши для копирования; source - новый источник скопированного события; target - новый целевой объект скопированного события; type - новый тип MouseDragEvent; gestureSource - новый источник жеста; pickResult - результат выбора. Может быть null, в этом случае результат 2D-выбора создаётся на основе координат сцены
Returns:: новое событие MouseDragEvent, созданное из MouseEvent
Since:: JavaFX 8.0

isDragDetect

public boolean isDragDetect()

Определяет, будет ли этому событию следовать событие DRAG_DETECTED. Действует только для событий MOUSE_PRESSED и MOUSE_DRAGGED.

Returns:: true, если событие DRAG_DETECTED последует за текущим

setDragDetect

public void setDragDetect(boolean dragDetect)

Изменяет поведение обнаружения перетаскивания. Указывает, будет ли этому событию следовать событие DRAG_DETECTED. Действует только для событий MOUSE_PRESSED и MOUSE_DRAGGED.

Parameters:: dragDetect - true, если за этим событием последует событие DRAG_DETECTED

getX

public final double getX()

Горизонтальная позиция события относительно начала координат источника MouseEvent.

Returns:: горизонтальная позиция события относительно начала координат источника MouseEvent.

getY

public final double getY()

Вертикальная позиция события относительно начала координат источника MouseEvent.

Returns:: вертикальная позиция события относительно начала координат источника MouseEvent.

getZ

public final double getZ()

Глубина позиции события относительно начала координат источника MouseEvent.

Returns:: глубина позиции события относительно начала координат источника MouseEvent.
Since:: JavaFX 8.0

getScreenX

public final double getScreenX()

Возвращает абсолютную горизонтальную позицию события.

Returns:: абсолютная горизонтальная позиция события

getScreenY

public final double getScreenY()

Возвращает абсолютную вертикальную позицию события.

Returns:: абсолютная вертикальная позиция события

getSceneX

public final double getSceneX()

Возвращает горизонтальную позицию события относительно начала координат Scene, содержащего источник MouseEvent. Если узел не находится в Scene, то значение относительно boundsInParent самого корневого родителя узла MouseEvent. Обратите внимание, что в 3D-сцене это представляет плоские координаты после применения проекционных преобразований.

Returns:: горизонтальная позиция события относительно начала координат Scene, содержащего источник MouseEvent

getSceneY

public final double getSceneY()

Возвращает вертикальную позицию события относительно начала координат Scene, содержащего источник MouseEvent. Если узел не находится в Scene, то значение относительно boundsInParent самого корневого родителя узла MouseEvent. Обратите внимание, что в 3D-сцене это представляет плоские координаты после применения проекционных преобразований.

Returns:: вертикальная позиция события относительно начала координат Scene, содержащего источник MouseEvent

getButton

public final MouseButton getButton()

Какая, если есть, кнопка мыши ответственна за это событие.

Returns:: кнопка мыши, изменение состояния которой вызвало это событие

getClickCount

public final int getClickCount()

Возвращает количество нажатий мыши, связанных с этим событием. Все события MOUSE_MOVED имеют значение clickCount, равное 0. Значение увеличивается при событии MOUSE_PRESSED и остается таким для всех последующих событий до MOUSE_RELEASED, включая сгенерированное событие MOUSE_CLICKED. Значение увеличивается до значений больше единицы, если все события между двумя последовательными нажатиями происходят в небольшой области и в короткий промежуток времени (согласно конфигурации родной операционной системы).

Returns:: количество нажатий мыши, связанных с этим событием

isStillSincePress

public final boolean isStillSincePress()

Указывает, оставался ли курсор мыши в заданной области гистерезиса со времени последнего нажатия, произошедшего до этого события.

Событие клика генерируется для узла, если мышь была и нажата, и отпущена над узлом, независимо от перемещений мыши между нажатием и отпусканием. Если узел хочет реагировать по-разному на простой клик и перетаскивание, он должен использовать системный порог короткого расстояния для определения клика и перетаскивания (пользователи часто совершают случайные незначительные перемещения во время клика). Это легко достигается путём игнорирования всех перетаскиваний, если данный метод возвращает true, и игнорирования всех кликов, если этот метод возвращает false.

Returns:: true, если значительных перемещений мыши (вне области гистерезиса системы) не было с момента последнего нажатия, произошедшего перед этим событием.

isShiftDown

public final boolean isShiftDown()

Указывает, нажата ли клавиша Shift во время этого события.

Returns:: true, если клавиша Shift нажата во время этого события

isControlDown

public final boolean isControlDown()

Указывает, нажата ли клавиша Control во время этого события.

Returns:: true, если клавиша Control нажата во время этого события

isAltDown

public final boolean isAltDown()

Указывает, нажата ли клавиша Alt при данном событии.

Возвращает:: true, если клавиша Alt нажата при этом событии

isMetaDown

public final boolean isMetaDown()

Указывает, нажата ли клавиша Meta при данном событии.

Возвращает:: true, если клавиша Meta нажата при этом событии

isSynthesized

public boolean isSynthesized()

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

Возвращает:: true, если это событие синтезировано с использованием сенсорного экрана
С:: JavaFX 2.2

isShortcutDown

public final boolean isShortcutDown()

Возвращает, нажата ли клавиша-модификатор, обычно используемая в сочетаниях клавиш на данной платформе. Например, control на Windows и meta (клавиша Command) на Mac.

Возвращает:: true, если клавиша-модификатор нажата, false в противном случае

isPopupTrigger

public final boolean isPopupTrigger()

Возвращает true, если это событие мыши является событием срабатывания всплывающего меню на данной платформе.

Примечание: Всплывающие меню срабатывают по-разному на разных системах. Поэтому, popupTrigger следует проверять как на onMousePressed, так и на mouseReleased для правильной кроссплатформенной функциональности.

Возвращает:: true, если это событие мыши является событием срабатывания всплывающего меню на данной платформе
С:: JavaFX 8.0

isPrimaryButtonDown

public final boolean isPrimaryButtonDown()

Возвращает true, если кнопка 1 (обычно левая) нажата. Обратите внимание, что это отличается от метода getButton(), который указывает, какая кнопка вызвала это событие, в то время как этот метод указывает, нажата ли первичная кнопка.

Возвращает:: true, если первичная кнопка (кнопка 1, обычно левая) нажата

isSecondaryButtonDown

public final boolean isSecondaryButtonDown()

Возвращает true, если вторичная кнопка (кнопка 3, обычно правая) нажата. Обратите внимание, что это отличается от метода getButton(), который указывает, какая кнопка вызвала это событие, в то время как этот метод указывает, нажата ли вторичная кнопка.

Возвращает:: true, если вторичная кнопка (кнопка 3, обычно правая) нажата

isMiddleButtonDown

public final boolean isMiddleButtonDown()

Возвращает true, если средняя кнопка (кнопка 2) нажата. Обратите внимание, что это отличается от метода getButton(), который указывает, какая кнопка вызвала это событие, в то время как этот метод указывает, нажата ли средняя кнопка.

Возвращает:: true, если средняя кнопка (кнопка 2) нажата

isBackButtonDown

public final boolean isBackButtonDown()

Возвращает true, если кнопка "Назад" (кнопка 4) нажата. Обратите внимание, что это отличается от метода getButton(), который указывает, какая кнопка вызвала это событие, в то время как этот метод указывает, нажата ли кнопка "Назад".

Возвращает:: true, если кнопка "Назад" (кнопка 4) нажата
С:: 12

isForwardButtonDown

public final boolean isForwardButtonDown()

Возвращает true, если кнопка "Вперёд" (кнопка 5) нажата. Обратите внимание, что это отличается от метода getButton(), который указывает, какая кнопка вызвала это событие, в то время как этот метод указывает, нажата ли кнопка "Вперёд".

Возвращает:: true, если кнопка "Вперёд" (кнопка 5) нажата
С:: 12

toString

public String toString()

Возвращает строковое представление этого объекта MouseEvent.

Переопределяет:: toString в классе EventObject
Возвращает:: строковое представление этого объекта MouseEvent.

getPickResult

public final PickResult getPickResult()

Возвращает информацию о выборе.

Возвращает:: новый объект PickResult, содержащий информацию о выборе
С:: JavaFX 8.0

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.