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

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

Модификатор и тип	Метод	Описание
`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
`final MouseButton`	`getButton()`	Какая, если таковая имеется, кнопка мыши отвечает за это событие.
`final int`	`getClickCount()`	Возвращает количество щелчков мыши, связанных с этим событием.
`EventType<? extends MouseEvent>`	`getEventType()`	Получает тип события этого события.
`final PickResult`	`getPickResult()`	Возвращает информацию о выборе.
`final double`	`getSceneX()`	Возвращает горизонтальную позицию события относительно начала координат `Scene`, содержащего источник MouseEvent.
`final double`	`getSceneY()`	Возвращает вертикальную позицию события относительно начала координат `Scene`, содержащего источник MouseEvent.
`final double`	`getScreenX()`	Возвращает абсолютную горизонтальную позицию события.
`final double`	`getScreenY()`	Возвращает абсолютную вертикальную позицию события.
`final double`	`getX()`	Горизонтальная позиция события относительно начала координат источника MouseEvent.
`final double`	`getY()`	Вертикальная позиция события относительно начала координат источника MouseEvent.
`final double`	`getZ()`	Позиция глубины события относительно начала координат источника MouseEvent.
`final boolean`	`isAltDown()`	Указывает, нажата ли клавиша Alt при этом событии.
`final boolean`	`isBackButtonDown()`	Возвращает `true`, если кнопка «Назад» (кнопка 4) нажата.
`final boolean`	`isControlDown()`	Указывает, нажата ли клавиша Control при этом событии.
`boolean`	`isDragDetect()`	Определяет, будет ли этому событию следовать событие `DRAG_DETECTED`.
`final boolean`	`isForwardButtonDown()`	Возвращает `true`, если кнопка «Вперед» (кнопка 5) нажата.
`final boolean`	`isMetaDown()`	Указывает, нажата ли клавиша Meta при этом событии.
`final boolean`	`isMiddleButtonDown()`	Возвращает `true`, если нажата средняя кнопка (кнопка 2).
`final boolean`	`isPopupTrigger()`	Возвращает `true`, если это событие мыши является событием срабатывания всплывающего меню для платформы.
`final boolean`	`isPrimaryButtonDown()`	Возвращает `true`, если нажата основная кнопка (кнопка 1, обычно левая).
`final boolean`	`isSecondaryButtonDown()`	Возвращает `true`, если нажата дополнительная кнопка (кнопка 3, обычно правая).
`final boolean`	`isShiftDown()`	Указывает, нажата ли клавиша Shift при этом событии.
`final boolean`	`isShortcutDown()`	Возвращает значение, указывающее, нажата ли общая клавиша-модификатор хост-платформы при этом событии.
`final 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

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 с null-источником и -целью. Оба 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 с null-источником и -целью.

Параметры:: 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.

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, если была нажата клавиша Ctrl.; altDown - true, если была нажата клавиша Alt.; metaDown - true, если была нажата клавиша Meta.; primaryButtonDown - true, если была нажата основная кнопка.; middleButtonDown - true, если была нажата средняя кнопка.; secondaryButtonDown - true, если была нажата дополнительная кнопка.; synthesized - Если это событие было синтезировано; popupTrigger - Является ли это событие триггером всплывающего меню для текущей платформы; stillSincePress - см. isStillSincePress(); pickResult - результат выбора. Может быть null, в этом случае результат 2D выбора без дополнительных значений создается на основе координат сцены и целевого объекта
Since:: 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, если была нажата клавиша Ctrl.; altDown - true, если была нажата клавиша Alt.; metaDown - true, если была нажата клавиша Meta.; primaryButtonDown - true, если была нажата основная кнопка.; middleButtonDown - true, если была нажата средняя кнопка.; secondaryButtonDown - true, если была нажата дополнительная кнопка.; backButtonDown - true, если была нажата кнопка назад.; forwardButtonDown - 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)

Создаёт копию события мыши типа 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 - Будет ли за событием следовать событие 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:: кнопка мыши, изменение состояния которой вызвало это событие

END_OF_DOCUMENT_MARKER

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 в этом событии.

Returns:: true, если модификатор Alt удерживается в этом событии

isMetaDown

public final boolean isMetaDown()

Указывает, удерживается ли модификатор Meta в этом событии.

Returns:: true, если модификатор Meta удерживается в этом событии
Since:: JavaFX 2.2

isSynthesized

public boolean isSynthesized()

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

Returns:: true, если это событие синтезировано из использования сенсорного экрана
Since:: JavaFX 2.2

isShortcutDown

public final boolean isShortcutDown()

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

Returns:: true, если клавиша быстрого доступа удерживается, false в противном случае

isPopupTrigger

public final boolean isPopupTrigger()

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

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

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

isPrimaryButtonDown

public final boolean isPrimaryButtonDown()

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

Returns:: true, если первичная кнопка (кнопка 1, обычно левая) в данный момент нажата

isSecondaryButtonDown

public final boolean isSecondaryButtonDown()

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

Returns:: true, если вторичная кнопка (кнопка 3, обычно правая) в данный момент нажата

isMiddleButtonDown

public final boolean isMiddleButtonDown()

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

Returns:: true, если средняя кнопка (кнопка 2) в данный момент нажата

isBackButtonDown

public final boolean isBackButtonDown()

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

Returns:: true, если кнопка "Назад" (кнопка 4) в данный момент нажата
Since:: 12

isForwardButtonDown

public final boolean isForwardButtonDown()

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

Returns:: true, если кнопка "Вперёд" (кнопка 5) в данный момент нажата
Since:: 12

toString

public String toString()

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

Overrides:: toString в классе EventObject
Returns:: строковое представление этого объекта MouseEvent.

getPickResult

public final PickResult getPickResult()

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

Returns:: новый объект PickResult, содержащий информацию о выборе
Since:: 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.