Класс 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 на узле или сцене — система переходит в режим перетаскивания и перекладывания, и вместо MouseEvent начинают доставляться DragEvent. Если вы не вызываете ни один из этих методов, простой жест нажатия-перетаскивания-отпускания продолжается.

Обратите внимание, что перетаскивание пальца по сенсорному экрану создает события перетаскивания мыши, а также события жеста прокрутки. Если это означает конфликт в приложении (физическое действие перетаскивания обрабатывается двумя разными обработчиками), метод 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 с null-значениями source и target.
`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-значениями source и target.

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

Модификатор и тип	Метод	Описание
`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()`	Возвращает значение true, если модификатор Alt нажат в данном событии.
`final boolean`	`isBackButtonDown()`	Возвращает true, если клавиша Back (кнопка 4) нажата.
`final boolean`	`isControlDown()`	Возвращает значение true, если модификатор Control нажат в данном событии.
`boolean`	`isDragDetect()`	Определяет, будет ли за событием следовать событие `DRAG_DETECTED`.
`final boolean`	`isForwardButtonDown()`	Возвращает true, если клавиша Forward (кнопка 5) нажата.
`final boolean`	`isMetaDown()`	Возвращает значение true, если модификатор Meta нажат в данном событии.
`final boolean`	`isMiddleButtonDown()`	Возвращает true, если клавиша Middle (кнопка 2) нажата.
`final boolean`	`isPopupTrigger()`	Возвращает true, если данное событие мыши является событием срабатывания всплывающего меню для платформы.
`final boolean`	`isPrimaryButtonDown()`	Возвращает true, если основная кнопка мыши (кнопка 1, обычно левая) нажата.
`final boolean`	`isSecondaryButtonDown()`	Возвращает true, если дополнительная кнопка мыши (кнопка 3, обычно правая) нажата.
`final boolean`	`isShiftDown()`	Возвращает значение true, если модификатор Shift нажат в данном событии.
`final boolean`	`isShortcutDown()`	Возвращает значение true, если общая клавиша быстрого доступа на платформе нажата в данном событии.
`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 обработчик событий следует использовать.

См. также:

MOUSE_ENTERED

public static final EventType<MouseEvent> MOUSE_ENTERED

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

См. также:

MOUSE_EXITED_TARGET

public static final EventType<MouseEvent> MOUSE_EXITED_TARGET

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

См. также:

MOUSE_EXITED

public static final EventType<MouseEvent> MOUSE_EXITED

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

См. также:

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 source и target. И isBackButtonDown(), и isForwardButtonDown() для этого события вернут false.

Параметры:: eventType - Тип события.; x - Координата x относительно сцены.; y - Координата y относительно сцены.; screenX - Координата x относительно экрана.; screenY - Координата y относительно экрана.; button - Используемая кнопка мыши; clickCount - Количество нажатий; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Control.; 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 source и target.

Параметры:: eventType - Тип события.; x - Координата x относительно сцены.; y - Координата y относительно сцены.; screenX - Координата x относительно экрана.; screenY - Координата y относительно экрана.; button - Используемая кнопка мыши; clickCount - Количество нажатий; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Control.; 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 не является Node.; y - Y-координата относительно источника. Должна быть в координатах сцены, если source == null или source не является Node.; screenX - X-координата относительно экрана.; screenY - Y-координата относительно экрана.; button - используемая кнопка мыши; clickCount - количество нажатий; shiftDown - true, если нажата клавиша Shift.; controlDown - true, если нажата клавиша Control.; 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.

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

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

getEventType

public EventType<? extends MouseEvent> getEventType()

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

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

Переопределяет:: getEventType в классе Event
Возвращает:: тип события

copyFor

public MouseEvent copyFor(Object newSource, EventTarget newTarget)

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

Переопределяет:: copyFor в классе Event
Параметры:: newSource - Новый источник события; newTarget - Новый целевой объект события
Возвращает:: копию события для другого источника и целевого объекта

copyFor

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

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

Параметры:: newSource - новый источник скопированного события; newTarget - новый целевой объект скопированного события; eventType - новый тип события
Возвращает:: копию события с заменёнными полями
С тех пор:: JavaFX 8.0

copyForMouseDragEvent

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

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

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

isDragDetect

public boolean isDragDetect()

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

Возвращает:: true, если за событием последует событие DRAG_DETECTED

setDragDetect

public void setDragDetect(boolean dragDetect)

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

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

getX

public final double getX()

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

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

getY

public final double getY()

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

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

getZ

public final double getZ()

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

Возвращает:: глубина позиции события относительно начала координат источника MouseEvent.
С тех пор:: JavaFX 8.0

getScreenX

public final double getScreenX()

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

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

getScreenY

public final double getScreenY()

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

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

getSceneX

public final double getSceneX()

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

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

getSceneY

public final double getSceneY()

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

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

getButton

public final MouseButton getButton()

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

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

getClickCount

public final int getClickCount()

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

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

isStillSincePress

public final boolean isStillSincePress()

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

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

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

isShiftDown

public final boolean isShiftDown()

Нажата ли клавиша Shift при данном событии.

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

isControlDown

public final boolean isControlDown()

Нажата ли клавиша Control при данном событии.

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

isAltDown

public final boolean isAltDown()

Нажата ли клавиша Alt при данном событии.

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

isMetaDown

public final boolean isMetaDown()

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

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

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.