Spec-Zone .ru
спецификации, руководства, описания, API
|
public class MouseEvent extends InputEvent
EventDispatcher
. Мышь расположение (указателя) доступна относительно нескольких систем координат: x, y - относительно источника узла MouseEvent, sceneX, sceneY - относительно к источнику Scene
это содержит узел, screenX, screenY - относительно источника экрана, который содержит указатель мыши.
Есть три типа перетаскивания жестов. Они все инициируются событием щелчка мышью и завершаются в результате мыши выпущенное событие, исходный узел решает, какой жест будет иметь место.
Простой жест "нажатие перетаскивает выпуск", значение по умолчанию. Это лучше всего используется, чтобы позволить изменять размер формы, перетаскивая это вокруг и так далее. Целый жест "нажатие перетаскивает выпуск", поставляется одному узлу. Когда кнопка мыши нажимается, самый верхний узел выбирается, и все последующие события от нажатия мыши поставляются тому же самому узлу, пока кнопка не отпускается. Если мышь, событие, по которому щелкают, сгенерировано от этих событий, оно все еще поставляется тому же самому узлу.
Во время простого жеста "нажатие перетаскивает выпуск", другие узлы не включаются и не получают событий. Если эти узлы должны быть включены в жест, полный жест "нажатие перетаскивает выпуск", должен быть активирован. Этот жест лучше всего используется для того, чтобы соединить узлы по "проводам", перетаскивая узлы к другим узлам и т.д. Этот тип жеста более близко описывается в MouseDragEvent
который содержит события, поставленные целям жеста.
Третий тип жеста поддерживается платформой жест перетаскивать-и-отбрасывать. Это служит лучше всего, чтобы передать данные и работы также между (не обязательно FX) приложения. Этот тип жеста более близко описывается в DragEvent
.
В кратком изложении простой жест "нажатие перетаскивает выпуск", активируется автоматически, когда кнопка мыши нажимается и поставляет все MouseEvent
s к источнику жеста. Когда Вы начинаете перетаскивать, в конечном счете DRAG_DETECTED
событие прибывает. В его обработчике можно или запустить, полный жест "нажатие перетаскивает выпуск", вызывая startFullDrag
метод на узле или сцене - MouseDragEvent
s начинают поставляться целям жеста, или можно запустить, перетаскивают и отбрасывают жест, вызывая startDragAndDrop
метод на узле или сцене - система переключается в режим перетаскивания и отбрасывания и DragEvent
s начинают поставляться вместо MouseEvent
s. Если Вы не вызываете ни одного из тех методов, простой жест "нажатие перетаскивает выпуск", продолжается.
Отметьте, что перетаскивание пальца по сенсорному экрану производит события перетаскивания мыши, но также и прокрутите события жеста. Если это означает конфликт в приложении (физическое действие перетаскивания обрабатывается двумя различными обработчиками), 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
для пузырящейся фазы. Это - все еще одно событие, только переключающее типы, так, если это фильтруется или используется, это влияет на обе разновидности события. Благодаря отношению подтипа, a MOUSE_ENTERED_TARGET
обработчик событий получит MOUSE_ENTERED
событие на цели.
ContextMenuEvent
.Модификатор и Тип | Поле и Описание |
---|---|
static EventType<MouseEvent> |
ЛЮБОЙ
Общий супертип для всех типов события от нажатия мыши.
|
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
Это событие имеет место, когда кнопка мыши отпускается.
|
consumed, eventType, NULL_SOURCE_TARGET, 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 с нулевым источником и целью.
|
MouseEvent(java.lang.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 |
copyFor(java.lang.Object newSource, EventTarget newTarget)
Копии это событие для различного источника и цели.
|
MouseEvent |
copyFor(java.lang.Object newSource, EventTarget newTarget, EventType<? extends MouseEvent> eventType)
Создает копию данного события с данными полями, которыми заменяют.
|
static MouseDragEvent |
copyForMouseDragEvent(MouseEvent e, java.lang.Object source, EventTarget target, EventType<MouseDragEvent> type, java.lang.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()
Снижается ли модификатор Высокого звука на этом событии.
|
boolean |
isControlDown()
Снижается ли модификатор Управления на этом событии.
|
boolean |
isDragDetect()
Определяет, будет ли это событие сопровождаться
DRAG_DETECTED событие. |
boolean |
isMetaDown()
Снижается ли модификатор Меты на этом событии.
|
boolean |
isMiddleButtonDown()
Возвраты
true если средняя кнопка (кнопка 2) в настоящий момент нажимается. |
boolean |
isPopupTrigger() |
boolean |
isPrimaryButtonDown()
Возвраты
true если основная кнопка (кнопка 1, обычно покинутые) в настоящий момент нажимается. |
boolean |
isSecondaryButtonDown()
Возвраты
true если вторичная кнопка (кнопка 1, обычно право) в настоящий момент нажимается. |
boolean |
isShiftDown()
Снижается ли модификатор Сдвига на этом событии.
|
boolean |
isShortcutDown()
Возвраты, снижается ли платформа узла общий модификатор ярлыка на этом событии.
|
boolean |
isStillSincePress()
Указывает, остался ли курсор мыши в обеспеченной системой гистерезисной области начиная с последнего нажатого события, которое произошло перед этим событием.
|
boolean |
isSynthesized()
Указывает, синтезируется ли это событие от использования сенсорного экрана вместо обычных исходных устройств события от нажатия мыши как мышь или сенсорная панель.
|
void |
setDragDetect(boolean dragDetect)
Приращения перетаскивают поведение обнаружения.
|
java.lang.String |
toString()
Возвращает строковое представление этого
MouseEvent объект. |
public static final EventType<MouseEvent> ЛЮБОЙ
public static final EventType<MouseEvent> MOUSE_PRESSED
public static final EventType<MouseEvent> MOUSE_RELEASED
public static final EventType<MouseEvent> MOUSE_CLICKED
public static final EventType<MouseEvent> MOUSE_ENTERED_TARGET
MOUSE_ENTERED
обработчик событий должен использоваться.public static final EventType<MouseEvent> MOUSE_ENTERED
MOUSE_ENTERED_TARGET
.public static final EventType<MouseEvent> MOUSE_EXITED_TARGET
MOUSE_EXITED
обработчик событий должен использоваться.public static final EventType<MouseEvent> MOUSE_EXITED
MOUSE_EXITED_TARGET
.public static final EventType<MouseEvent> MOUSE_MOVED
public static final EventType<MouseEvent> MOUSE_DRAGGED
public static final EventType<MouseEvent> DRAG_DETECTED
startFullDrag()
из startDragAndDrop()
метод). Если ни одного из них не вызывают, простой жест "нажатие перетаскивает выпуск", будет продолжаться. Отметьте, что его событие сгенерировано основанное на перетаскивании мыши по специфичному для платформы порогу расстояния. Можно изменить это поведение, вызывая setDragDetect
метод на любом событии MOUSE_PRESSED ИЛИ MOUSE_DRAGGED.
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)
eventType
- Тип события.x
- X относительно сцены.y
- Y относительно сцены.screenX
- X координируют относительно экрана.screenY
- Y координируют относительно экрана.button
- кнопка мыши используетсяclickCount
- число количеств щелчкаshiftDown
- истина, если модификатор сдвига был нажат.controlDown
- истина, если модификатор управления был нажат.altDown
- истина, если модификатор alt был нажат.metaDown
- истина, если meta модификатор был нажат.primaryButtonDown
- истина, если основная кнопка была нажата.middleButtonDown
- истина, если средняя кнопка была нажата.secondaryButtonDown
- истина, если вторичная кнопка была нажата.synthesized
- если это событие синтезировалосьpopupTrigger
- обозначает ли это событие раскрывающийся триггер для текущей платформыstillSincePress
- см. isStillSincePress()
pickResult
- выберите результат. Может быть нуль, в этом случае 2-D результат выбора без дальнейших значений создается основанный на координатах сценыpublic MouseEvent(java.lang.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)
source
- источник события. Может быть нуль.target
- цель события. Может быть нуль.eventType
- Тип события.x
- X относительно источника. Должен быть в координатах сцены, если источником == нуль или источник не является Узел.y
- Y относительно источника. Должен быть в координатах сцены, если источником == нуль или источник не является Узел.screenX
- X координируют относительно экрана.screenY
- Y координируют относительно экрана.button
- кнопка мыши используетсяclickCount
- число количеств щелчкаshiftDown
- истина, если модификатор сдвига был нажат.controlDown
- истина, если модификатор управления был нажат.altDown
- истина, если модификатор alt был нажат.metaDown
- истина, если meta модификатор был нажат.primaryButtonDown
- истина, если основная кнопка была нажата.middleButtonDown
- истина, если средняя кнопка была нажата.secondaryButtonDown
- истина, если вторичная кнопка была нажата.synthesized
- если это событие синтезировалосьpopupTrigger
- обозначает ли это событие раскрывающийся триггер для текущей платформыstillSincePress
- см. isStillSincePress()
pickResult
- выберите результат. Может быть нуль, в этом случае 2-D результат выбора без дальнейших значений создается основанный на координатах сцены и целиpublic EventType<? extends MouseEvent> getEventType()
Event
Event
У class могут быть различные типы события. Эти событие вводит, далее определяют, какое событие имело место.getEventType
в class InputEvent
public MouseEvent copyFor(java.lang.Object newSource, EventTarget newTarget)
public MouseEvent copyFor(java.lang.Object newSource, EventTarget newTarget, EventType<? extends MouseEvent> eventType)
source
- новый источник скопированного событияtarget
- новая цель скопированного событияeventType
- новый eventTypepublic static MouseDragEvent copyForMouseDragEvent(MouseEvent e, java.lang.Object source, EventTarget target, EventType<MouseDragEvent> type, java.lang.Object gestureSource, PickResult pickResult)
e
- событие от нажатия мыши, чтобы скопироватьsource
- новый источник скопированного событияtarget
- новая цель скопированного событияtype
- новый тип MouseDragEventgestureSource
- новый источник жестаpickResult
- выберите результат. Может быть нуль, в этом случае 2-D результат выбора без дальнейших значений создается основанный на координатах сценыpublic boolean isDragDetect()
DRAG_DETECTED
событие. Это имеет эффект только с MOUSE_PRESSED
и MOUSE_DRAGGED
события.DRAG_DETECTED
событие будет следоватьpublic void setDragDetect(boolean dragDetect)
DRAG_DETECTED
событие. Это имеет эффект только с MOUSE_PRESSED
и MOUSE_DRAGGED
события.dragDetect
- Ли DRAG_DETECTED
событие будет следоватьpublic final double getX()
public final double getY()
public final double getZ()
public final double getScreenX()
public final double getScreenY()
public final double getSceneX()
Scene
это содержит источник MouseEvent. Если узел не находится в a Scene
, тогда значение относительно boundsInParent корневого больше всего родителя узла MouseEvent. Отметьте, что в 3-D сцене, это представляет плоские координаты после применения трансформаций проекции.Scene
это содержит источник MouseEventpublic final double getSceneY()
Scene
это содержит источник MouseEvent. Если узел не находится в a Scene
, тогда значение относительно boundsInParent корневого больше всего родителя узла MouseEvent. Отметьте, что в 3-D сцене, это представляет плоские координаты после применения трансформаций проекции.Scene
это содержит источник MouseEventpublic final MouseButton getButton()
public final int getClickCount()
public final boolean isStillSincePress()
Событие щелчка сгенерировано для узла, если мышью и щелкнули и выпущена по узлу, независимо от перемещений мыши между нажатием и выпуском. Если узел хочет реагировать по-другому при простом щелчке, и при мыши перетаскивают, он должен использовать предоставленный систему порог короткого расстояния, чтобы решить между буксировкой (пользователи часто выполняют непреднамеренные крошечные перемещения во время щелчка). Это может быть легко достигнуто, игнорируя все, перетаскивает с этим возвратом метода true
и игнорирование всех щелчков с этим возвратом метода false
.
public final boolean isShiftDown()
public final boolean isControlDown()
public final boolean isAltDown()
public final boolean isMetaDown()
public boolean isSynthesized()
public final boolean isShortcutDown()
control
на Windows и meta
(командная клавиша) на Mac.true
если модификатор ярлыка снижается, false
иначеpublic final boolean isPopupTrigger()
public final boolean isPrimaryButtonDown()
true
если основная кнопка (кнопка 1, обычно покинутые) в настоящий момент нажимается. Отметьте, что это отличается от getButton()
метод, который указывает, какое нажатие кнопки было ответственно за это событие, в то время как этот метод указывает, подавляется ли основная кнопка.true
если основная кнопка (кнопка 1, обычно покинутые) в настоящий момент нажимаетсяpublic final boolean isSecondaryButtonDown()
true
если вторичная кнопка (кнопка 1, обычно право) в настоящий момент нажимается. Отметьте, что это отличается от getButton()
метод, который указывает, какое нажатие кнопки было ответственно за это событие, в то время как этот метод указывает, подавляется ли вторичная кнопка.true
если вторичная кнопка (кнопка 3, обычно право) в настоящий момент нажимаетсяpublic final boolean isMiddleButtonDown()
true
если средняя кнопка (кнопка 2) в настоящий момент нажимается. Отметьте, что это отличается от getButton()
метод, который указывает, какое нажатие кнопки было ответственно за это событие, в то время как этот метод указывает, подавляется ли средняя кнопка.true
если средняя кнопка (кнопка 2) в настоящий момент нажимаетсяpublic java.lang.String toString()
MouseEvent
объект.toString
в class java.util.EventObject
MouseEvent
объект.public final PickResult getPickResult()
Copyright (c) 2008, 2013, Oracle и/или его филиалы. Все права защищены. Использование подвергается