Spec-Zone.ru › OpenJDK 25

Класс MouseEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ComponentEvent
java.awt.event.InputEvent
java.awt.event.MouseEvent
Все реализуемые интерфейсы:
Serializable
Прямые известные подклассы:
MenuDragMouseEvent, MouseWheelEvent
public non-sealed class MouseEvent extends InputEvent
Событие, указывающее, что в компоненте произошло действие мыши. Действие мыши считается произошедшим в определённом компоненте тогда и только тогда, когда в момент действия указатель мыши находится над незакрытой частью границ компонента. Для облегчённых компонентов, таких как компоненты Swing, события мыши отправляются компоненту только в том случае, если для компонента включён соответствующий тип события мыши. Тип события мыши включается добавлением к компоненту соответствующего слушателя событий мыши на основе EventListener (MouseListener или MouseMotionListener) либо вызовом Component.enableEvents(long) с соответствующим параметром маски (AWTEvent.MOUSE_EVENT_MASK или AWTEvent.MOUSE_MOTION_EVENT_MASK). Если тип события мыши не включён для компонента, соответствующие события мыши отправляются первому предку, для которого этот тип включён.

Например, если к компоненту добавлен MouseListener или вызван enableEvents(AWTEvent.MOUSE_EVENT_MASK), все события, определённые MouseListener, отправляются компоненту. С другой стороны, если MouseMotionListener не добавлен и enableEvents не вызван с AWTEvent.MOUSE_MOTION_EVENT_MASK, события перемещения мыши компоненту не отправляются. Вместо этого события перемещения мыши отправляются первому предку, для которого они включены.

Это низкоуровневое событие генерируется объектом компонента при следующих действиях:

  • События мыши
    • нажатие кнопки мыши
    • отпускание кнопки мыши
    • щелчок кнопкой мыши (нажатие и отпускание)
    • указатель мыши входит в незакрытую часть области компонента
    • указатель мыши покидает незакрытую часть области компонента
  • События перемещения мыши
    • перемещение мыши
    • перетаскивание мыши

Объект MouseEvent передаётся каждому объекту MouseListener или MouseAdapter, зарегистрированному для получения «интересующих» событий мыши с помощью метода компонента addMouseListener. (Объекты MouseAdapter реализуют интерфейс MouseListener.) Каждый такой объект-слушатель получает MouseEvent, содержащий событие мыши.

Объект MouseEvent также передаётся каждому объекту MouseMotionListener или MouseMotionAdapter, зарегистрированному для получения событий перемещения мыши с помощью метода компонента addMouseMotionListener. (Объекты MouseMotionAdapter реализуют интерфейс MouseMotionListener.) Каждый такой объект-слушатель получает MouseEvent, содержащий событие перемещения мыши.

При щелчке кнопкой мыши события генерируются и отправляются зарегистрированным MouseListener. Состояние клавиш-модификаторов можно получить с помощью InputEvent.getModifiers() и InputEvent.getModifiersEx(). Маска кнопки, возвращаемая InputEvent.getModifiers(), отражает только кнопку, состояние которой изменилось, а не текущее состояние всех кнопок. (Примечание. Из-за пересечения значений ALT_MASK/BUTTON2_MASK и META_MASK/BUTTON3_MASK это не всегда верно для событий мыши с клавишами-модификаторами.) Чтобы получить состояние всех кнопок и клавиш-модификаторов, используйте InputEvent.getModifiersEx(). Кнопка, состояние которой изменилось, возвращается методом getButton()

Например, если нажата первая кнопка мыши, события отправляются в следующем порядке: 


    id              modifiers    button
    MOUSE_PRESSED:  BUTTON1_MASK BUTTON1
    MOUSE_RELEASED: BUTTON1_MASK BUTTON1
    MOUSE_CLICKED:  BUTTON1_MASK BUTTON1
При нажатии нескольких кнопок мыши каждое нажатие, отпускание и щелчок приводит к отдельному событию.

Например, если пользователь нажимает кнопку 1, затем кнопку 2, а потом отпускает их в том же порядке, генерируется следующая последовательность событий: 


    id              modifiers    button
    MOUSE_PRESSED:  BUTTON1_MASK BUTTON1
    MOUSE_PRESSED:  BUTTON2_MASK BUTTON2
    MOUSE_RELEASED: BUTTON1_MASK BUTTON1
    MOUSE_CLICKED:  BUTTON1_MASK BUTTON1
    MOUSE_RELEASED: BUTTON2_MASK BUTTON2
    MOUSE_CLICKED:  BUTTON2_MASK BUTTON2
Если кнопка 2 отпущена первой, сначала поступает пара MOUSE_RELEASED/MOUSE_CLICKED для BUTTON2_MASK, а затем пара для BUTTON1_MASK.

К стандартному набору кнопок, представленному следующими константами, добавляются дополнительные кнопки мыши: BUTTON1, BUTTON2 и BUTTON3. Для дополнительных кнопок не назначены константы BUTTONx, а их маскам кнопок не назначены константы BUTTONx_DOWN_MASK. Тем не менее в качестве номеров кнопок (идентификаторов кнопок) можно использовать порядковые номера, начиная с 4. Значения, полученные методом getMaskForButton(button), можно использовать в качестве масок кнопок.

События MOUSE_DRAGGED доставляются объекту Component, в котором была нажата кнопка мыши, до отпускания этой кнопки (независимо от того, находится ли указатель мыши в пределах Component). Из-за платформозависимой реализации перетаскивания MOUSE_DRAGGED могут не доставляться во время собственной операции перетаскивания. В среде с несколькими экранами события перетаскивания мыши доставляются объекту Component, даже если указатель мыши находится за пределами GraphicsConfiguration, связанного с этим Component. Однако в этом случае сообщаемое положение при перетаскивании мыши может отличаться от фактического положения указателя мыши:

  • В среде с несколькими экранами без виртуального устройства:
    сообщаемые координаты при перетаскивании мыши ограничиваются границами GraphicsConfiguration, связанного с Component.
  • В среде с несколькими экранами с виртуальным устройством:
    сообщаемые координаты при перетаскивании мыши ограничиваются границами виртуального устройства, связанного с Component.

Поведение не определено, если параметр id любого экземпляра MouseEvent не находится в диапазоне от MOUSE_FIRST до MOUSE_LAST-1 (значение MOUSE_WHEEL недопустимо).

С момента выпуска:
1.1
См. также:
  • MouseAdapter
  • MouseListener
  • MouseMotionAdapter
  • MouseMotionListener
  • MouseWheelListener
  • Учебное руководство: написание слушателя событий мыши
  • Учебное руководство: написание слушателя событий перемещения мыши
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final int BUTTON1
Обозначает кнопку мыши № 1; используется методом getButton().
static final int BUTTON2
Обозначает кнопку мыши № 2; используется методом getButton().
static final int BUTTON3
Обозначает кнопку мыши № 3; используется методом getButton().
static final int MOUSE_CLICKED
Событие «щелчок мышью».
static final int MOUSE_DRAGGED
Событие «перетаскивание мышью».
static final int MOUSE_ENTERED
Событие «указатель мыши вошёл».
static final int MOUSE_EXITED
Событие «указатель мыши вышел».
static final int MOUSE_FIRST
Первый номер в диапазоне идентификаторов, используемых для событий мыши.
static final int MOUSE_LAST
Последний номер в диапазоне идентификаторов, используемых для событий мыши.
static final int MOUSE_MOVED
Событие «перемещение мыши».
static final int MOUSE_PRESSED
Событие «нажатие кнопки мыши».
static final int MOUSE_RELEASED
Событие «отпускание кнопки мыши».
static final int MOUSE_WHEEL
Событие «колесо мыши».
static final int NOBUTTON
Обозначает отсутствие кнопок мыши; используется методом getButton().

Поля, объявленные в классе InputEvent

ALT_DOWN_MASK, ALT_GRAPH_DOWN_MASK, ALT_GRAPH_MASK, ALT_MASK, BUTTON1_DOWN_MASK, BUTTON1_MASK, BUTTON2_DOWN_MASK, BUTTON2_MASK, BUTTON3_DOWN_MASK, BUTTON3_MASK, CTRL_DOWN_MASK, CTRL_MASK, META_DOWN_MASK, META_MASK, SHIFT_DOWN_MASK, SHIFT_MASK

Поля, объявленные в классе ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Поля, объявленные в классе AWTEvent

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

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

source

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

Конструктор Описание
MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger)
Создаёт объект MouseEvent с указанными исходным компонентом, типом, модификаторами, координатами, числом щелчков и флагом popupTrigger.
MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int button)
Создаёт объект MouseEvent с указанными исходным компонентом, типом, временем, модификаторами, координатами, числом щелчков, флагом popupTrigger и номером кнопки.
MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int button)
Создаёт объект MouseEvent с указанными исходным компонентом, типом, временем, модификаторами, координатами, абсолютными координатами, числом щелчков, флагом popupTrigger и номером кнопки.

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

Модификатор и тип Метод Описание
int getButton()
Возвращает кнопку мыши, состояние которой изменилось, если такая есть.
int getClickCount()
Возвращает число щелчков мышью, связанных с этим событием.
Point getLocationOnScreen()
Возвращает абсолютные координаты x и y события.
static String getMouseModifiersText(int modifiers)
Возвращает экземпляр String, описывающий клавиши-модификаторы и кнопки мыши, нажатые во время события, например «Shift» или «Ctrl+Shift».
Point getPoint()
Возвращает координаты x и y события относительно исходного компонента.
int getX()
Возвращает горизонтальную координату x события относительно исходного компонента.
int getXOnScreen()
Возвращает абсолютную горизонтальную координату x события.
int getY()
Возвращает вертикальную координату y события относительно исходного компонента.
int getYOnScreen()
Возвращает абсолютную вертикальную координату y события.
boolean isPopupTrigger()
Возвращает значение, указывающее, является ли это событие мыши событием вызова всплывающего меню на данной платформе.
String paramString()
Возвращает строку параметров, идентифицирующую это событие.
void translatePoint(int x, int y)
Перемещает координаты события в новое положение, добавляя указанные смещения x (по горизонтали) и y (по вертикали).

Методы, объявленные в классе InputEvent

consume, getMaskForButton, getModifiers, getModifiersEx, getModifiersExText, getWhen, isAltDown, isAltGraphDown, isConsumed, isControlDown, isMetaDown, isShiftDown

Методы, объявленные в классе ComponentEvent

getComponent

Методы, объявленные в классе AWTEvent

getID, setSource, toString

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

getSource

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

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

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

MOUSE_FIRST

public static final int MOUSE_FIRST
Первый номер в диапазоне идентификаторов, используемых для событий мыши.
См. также:
  • Значения констант полей

MOUSE_LAST

public static final int MOUSE_LAST
Последний номер в диапазоне идентификаторов, используемых для событий мыши.
См. также:
  • Значения констант полей

MOUSE_CLICKED

public static final int MOUSE_CLICKED
Событие «щелчок мышью». Это MouseEvent возникает при нажатии и отпускании кнопки мыши.
См. также:
  • Значения констант полей

MOUSE_PRESSED

public static final int MOUSE_PRESSED
Событие «нажатие кнопки мыши». Это MouseEvent возникает при нажатии кнопки мыши.
См. также:
  • Значения констант полей

MOUSE_RELEASED

public static final int MOUSE_RELEASED
Событие «отпускание кнопки мыши». Это MouseEvent возникает при отпускании кнопки мыши.
См. также:
  • Значения констант полей

MOUSE_MOVED

public static final int MOUSE_MOVED
Событие «перемещение мыши». Это MouseEvent возникает при изменении положения мыши.
См. также:
  • Значения констант полей

MOUSE_ENTERED

public static final int MOUSE_ENTERED
Событие «вход указателя мыши». Это MouseEvent возникает, когда указатель мыши входит в незакрытую часть области компонента.
См. также:
  • Значения констант полей

MOUSE_EXITED

public static final int MOUSE_EXITED
Событие «выход указателя мыши». Это MouseEvent возникает, когда указатель мыши покидает незакрытую часть области компонента.
См. также:
  • Значения констант полей

MOUSE_DRAGGED

public static final int MOUSE_DRAGGED
Событие «перетаскивание мышью». Это MouseEvent возникает при изменении положения мыши с нажатой кнопкой.
См. также:
  • Значения констант полей

MOUSE_WHEEL

public static final int MOUSE_WHEEL
Событие «колесо мыши». Это единственное MouseWheelEvent. Оно возникает при вращении колеса мыши, оснащенной колесом.
Начиная с версии:
1.4
См. также:
  • Значения констант полей

NOBUTTON

public static final int NOBUTTON
Указывает на отсутствие кнопок мыши; используется методом getButton().
Начиная с версии:
1.4
См. также:
  • Значения констант полей

BUTTON1

public static final int BUTTON1
Указывает на кнопку мыши № 1; используется методом getButton().
Начиная с версии:
1.4
См. также:
  • Значения констант полей

BUTTON2

public static final int BUTTON2
Указывает на кнопку мыши № 2; используется методом getButton().
Начиная с версии:
1.4
См. также:
  • Значения констант полей

BUTTON3

public static final int BUTTON3
Указывает на кнопку мыши № 3; используется методом getButton().
Начиная с версии:
1.4
См. также:
  • Значения констант полей

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

MouseEvent

public MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int button)
Создает объект MouseEvent с указанными исходным компонентом, типом, временем, модификаторами, координатами, количеством щелчков, флагом popupTrigger и номером кнопки.

Создание недопустимого события (например, при использовании более одной старой маски _MASK или несоответствующих значений модификатора/кнопки) приводит к неопределенному поведению. Вызов вида MouseEvent(source, id, when, modifiers, x, y, clickCount, popupTrigger, button) ведет себя точно так же, как вызов MouseEvent(source, id, when, modifiers, x, y, xAbs, yAbs, clickCount, popupTrigger, button), где xAbs и yAbs определяются как координаты источника на экране плюс относительные координаты x и y. Если источник не отображается, для xAbs и yAbs задается значение ноль. Этот метод вызывает IllegalArgumentException, если source имеет значение null.

Параметры:
source — Component, породивший событие
id — целое число, указывающее тип события. Допустимые значения см. в описании класса MouseEvent
when — целое число типа long, задающее время возникновения события. Не рекомендуется передавать отрицательное или нулевое значение
modifiers — маска модификаторов, описывающая клавиши-модификаторы и кнопки мыши (например, shift, ctrl, alt и meta), нажатые во время события. В качестве значения этого параметра разрешено использовать только расширенные модификаторы (описание расширенных модификаторов см. в классе InputEvent.getModifiersEx()). Не рекомендуется передавать отрицательное значение. Нулевое значение означает, что модификаторы не передавались
x — горизонтальная координата x положения мыши. Допускается передавать отрицательные значения
y — вертикальная координата y положения мыши. Допускается передавать отрицательные значения
clickCount — количество щелчков мышью, связанных с событием. Не рекомендуется передавать отрицательное значение
popupTrigger — логическое значение, равное true, если это событие вызывает появление всплывающего меню
button — целое число, указывающее, у какой кнопки мыши изменилось состояние. К этому параметру применяются следующие правила:
  • Если Java disabled поддержку расширенных кнопок мыши, разрешено создавать объекты MouseEvent только со стандартными кнопками: NOBUTTON, BUTTON1, BUTTON2 и BUTTON3.
  • Если Java enabled поддержку расширенных кнопок мыши, разрешено создавать объекты MouseEvent со стандартными кнопками. Если Java enabled поддержку расширенных кнопок мыши, то помимо стандартных кнопок объекты MouseEvent можно создавать с кнопками из диапазона от 4 до MouseInfo.getNumberOfButtons(), если у мыши больше трех кнопок.
Исключения:
IllegalArgumentException — если button меньше нуля
IllegalArgumentException — если source равно null
IllegalArgumentException — если button больше BUTTON3, а Java disabled поддержку расширенных кнопок мыши
IllegalArgumentException — если button больше значения current number of buttons, а Java enabled поддержку расширенных кнопок мыши
IllegalArgumentException — если передано недопустимое значение button
IllegalArgumentException — если source равно null
Начиная с версии:
1.4
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • InputEvent.getWhen()
  • InputEvent.getModifiers()
  • getX()
  • getY()
  • getClickCount()
  • isPopupTrigger()
  • getButton()

MouseEvent

public MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger)
Создает объект MouseEvent с указанными исходным компонентом, типом, модификаторами, координатами, количеством щелчков и флагом popupTrigger. Вызов вида MouseEvent(source, id, when, modifiers, x, y, clickCount, popupTrigger) ведет себя точно так же, как вызов MouseEvent(source, id, when, modifiers, x, y, xAbs, yAbs, clickCount, popupTrigger, MouseEvent.NOBUTTON), где xAbs и yAbs определяются как координаты источника на экране плюс относительные координаты x и y. Если источник не отображается, для xAbs и yAbs задается значение ноль. Этот метод вызывает IllegalArgumentException, если source имеет значение null.
Параметры:
source — Component, породивший событие
id — целое число, указывающее тип события. Допустимые значения см. в описании класса MouseEvent
when — целое число типа long, задающее время возникновения события. Не рекомендуется передавать отрицательное или нулевое значение
modifiers — маска модификаторов, описывающая клавиши-модификаторы и кнопки мыши (например, shift, ctrl, alt и meta), нажатые во время события. В качестве значения этого параметра разрешено использовать только расширенные модификаторы (описание расширенных модификаторов см. в классе InputEvent.getModifiersEx()). Не рекомендуется передавать отрицательное значение. Нулевое значение означает, что модификаторы не передавались
x — горизонтальная координата x положения мыши. Допускается передавать отрицательные значения
y — вертикальная координата y положения мыши. Допускается передавать отрицательные значения
clickCount — количество щелчков мышью, связанных с событием. Не рекомендуется передавать отрицательное значение
popupTrigger — логическое значение, равное true, если это событие вызывает появление всплывающего меню
Исключения:
IllegalArgumentException — если source равно null
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • InputEvent.getWhen()
  • InputEvent.getModifiers()
  • getX()
  • getY()
  • getClickCount()
  • isPopupTrigger()

MouseEvent

public MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int button)
Создает объект MouseEvent с указанными исходным компонентом, типом, временем, модификаторами, координатами, абсолютными координатами, количеством щелчков, флагом popupTrigger и номером кнопки.

Создание недопустимого события (например, при использовании более одной старой маски _MASK или несоответствующих значений модификатора/кнопки) приводит к неопределенному поведению. Даже если конструктору переданы несогласованные значения относительных и абсолютных координат, экземпляр события мыши все равно создается и исключение не генерируется. Этот метод вызывает IllegalArgumentException, если source имеет значение null.

Параметры:
source — Component, породивший событие
id — целое число, указывающее тип события. Допустимые значения см. в описании класса MouseEvent
when — целое число типа long, задающее время возникновения события. Не рекомендуется передавать отрицательное или нулевое значение
modifiers — маска модификаторов, описывающая клавиши-модификаторы и кнопки мыши (например, shift, ctrl, alt и meta), нажатые во время события. В качестве значения этого параметра разрешено использовать только расширенные модификаторы (описание расширенных модификаторов см. в классе InputEvent.getModifiersEx()). Не рекомендуется передавать отрицательное значение. Нулевое значение означает, что модификаторы не передавались
x — горизонтальная координата x положения мыши. Допускается передавать отрицательные значения
y — вертикальная координата y положения мыши. Допускается передавать отрицательные значения
xAbs — абсолютная горизонтальная координата x положения мыши. Допускается передавать отрицательные значения
yAbs — абсолютная вертикальная координата y положения мыши. Допускается передавать отрицательные значения
clickCount — количество щелчков мышью, связанных с событием. Не рекомендуется передавать отрицательное значение
popupTrigger — логическое значение, равное true, если это событие вызывает появление всплывающего меню
button — целое число, указывающее, у какой кнопки мыши изменилось состояние. К этому параметру применяются следующие правила:
  • Если Java disabled поддержку расширенных кнопок мыши, разрешено создавать объекты MouseEvent только со стандартными кнопками: NOBUTTON, BUTTON1, BUTTON2 и BUTTON3.
  • Если Java enabled поддержку расширенных кнопок мыши, разрешено создавать объекты MouseEvent со стандартными кнопками. Если Java enabled поддержку расширенных кнопок мыши, то помимо стандартных кнопок объекты MouseEvent можно создавать с кнопками из диапазона от 4 до MouseInfo.getNumberOfButtons(), если у мыши больше трех кнопок.
Исключения:
IllegalArgumentException — если button меньше нуля
IllegalArgumentException — если source равно null
IllegalArgumentException — если button больше BUTTON3, а Java disabled поддержку расширенных кнопок мыши
IllegalArgumentException — если button больше значения current number of buttons, а Java enabled поддержку расширенных кнопок мыши
IllegalArgumentException — если передано недопустимое значение button
IllegalArgumentException — если source равно null
Начиная с версии:
1.6
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • InputEvent.getWhen()
  • InputEvent.getModifiers()
  • getX()
  • getY()
  • getXOnScreen()
  • getYOnScreen()
  • getClickCount()
  • isPopupTrigger()
  • getButton()
  • Toolkit.areExtraMouseButtonsEnabled()
  • MouseInfo.getNumberOfButtons()
  • InputEvent.getMaskForButton(int)

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

getLocationOnScreen

public Point getLocationOnScreen()
Возвращает абсолютные координаты x и y события. В среде с несколькими виртуальными экранами, где область рабочего стола может охватывать несколько физических экранов, эти координаты отсчитываются в виртуальной системе координат. В противном случае они отсчитываются в системе координат, связанной с GraphicsConfiguration компонента.
Возвращает:
объект Point, содержащий абсолютные координаты x и y.
Начиная с версии:
1.6
См. также:
  • GraphicsConfiguration

getXOnScreen

public int getXOnScreen()
Возвращает абсолютную горизонтальную координату x события. В среде с несколькими виртуальными экранами, где область рабочего стола может охватывать несколько физических экранов, эта координата отсчитывается в виртуальной системе координат. В противном случае она отсчитывается в системе координат, связанной с GraphicsConfiguration компонента.
Возвращает:
x — целое число, указывающее абсолютное горизонтальное положение.
Начиная с версии:
1.6
См. также:
  • GraphicsConfiguration

getYOnScreen

public int getYOnScreen()
Возвращает абсолютную вертикальную координату y события. В среде с несколькими виртуальными экранами, где область рабочего стола может охватывать несколько физических экранов, эта координата отсчитывается в виртуальной системе координат. В противном случае она отсчитывается в системе координат, связанной с GraphicsConfiguration компонента.
Возвращает:
y — целое число, указывающее абсолютное вертикальное положение.
Начиная с версии:
1.6
См. также:
  • GraphicsConfiguration

getX

public int getX()
Возвращает горизонтальную координату x события относительно исходного компонента.
Возвращает:
x — целое число, указывающее горизонтальное положение относительно компонента

getY

public int getY()
Возвращает вертикальную координату y события относительно исходного компонента.
Возвращает:
y — целое число, указывающее вертикальное положение относительно компонента

getPoint

public Point getPoint()
Возвращает координаты x и y события относительно исходного компонента.
Возвращает:
объект Point, содержащий координаты x и y относительно исходного компонента

translatePoint

public void translatePoint(int x, int y)
Смещает координаты события в новое положение, добавляя указанные смещения x (по горизонтали) и y (по вертикали).
Параметры:
x — горизонтальное значение x, добавляемое к текущей координате x
y — вертикальное значение y, добавляемое к текущей координате y

getClickCount

public int getClickCount()
Возвращает количество щелчков мышью, связанных с этим событием.
Возвращает:
целое значение, соответствующее количеству щелчков

getButton

public int getButton()
Возвращает номер кнопки мыши, состояние которой изменилось, если такая есть. Возвращаемое значение находится в диапазоне от 0 до значения MouseInfo.getNumberOfButtons(). Возвращаемое значение включает как минимум следующие константы:
  • NOBUTTON
  • BUTTON1
  • BUTTON2
  • BUTTON3
В приложении эти константы можно использовать для сравнения с возвращенным номером кнопки. Например, 
if (anEvent.getButton() == MouseEvent.BUTTON1) {
В частности, для мыши с одной, двумя или тремя кнопками этот метод может возвращать следующие значения:
  • 0 (NOBUTTON)
  • 1 (BUTTON1)
  • 2 (BUTTON2)
  • 3 (BUTTON3)
Для номеров кнопок больше BUTTON3 нет идентификатора-константы. Поэтому при подключенной мыши с пятью кнопками этот метод может возвращать следующие значения:
  • 0 (NOBUTTON)
  • 1 (BUTTON1)
  • 2 (BUTTON2)
  • 3 (BUTTON3)
  • 4
  • 5

Примечание. Если Java disabled поддержку расширенных кнопок мыши, подсистема событий AWT не создает события мыши для расширенных кнопок. Поэтому не следует ожидать, что этот метод вернет что-либо, кроме NOBUTTON, BUTTON1, BUTTON2, BUTTON3.

Возвращает:
одно из значений от 0 до MouseInfo.getNumberOfButtons(), если Java enabled поддержку расширенных кнопок мыши. Этот диапазон включает NOBUTTON, BUTTON1, BUTTON2, BUTTON3;
NOBUTTON, BUTTON1, BUTTON2 или BUTTON3, если Java disabled поддержку расширенных кнопок мыши
Начиная с версии:
1.4
См. также:
  • Toolkit.areExtraMouseButtonsEnabled()
  • MouseInfo.getNumberOfButtons()
  • MouseEvent(Component, int, long, int, int, int, int, int, int, boolean, int)
  • InputEvent.getMaskForButton(int)

isPopupTrigger

public boolean isPopupTrigger()
Возвращает признак того, является ли это событие мыши событием вызова всплывающего меню на данной платформе.

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

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

getMouseModifiersText

public static String getMouseModifiersText(int modifiers)
Возвращает экземпляр String, описывающий клавиши-модификаторы и кнопки мыши, нажатые во время события, например «Shift» или «Ctrl+Shift». Эти строки можно локализовать, изменив файл awt.properties.

Обратите внимание, что InputEvent.ALT_MASK и InputEvent.BUTTON2_MASK имеют одинаковые значения, поэтому для обоих модификаторов возвращается строка «Alt». Аналогично, InputEvent.META_MASK и InputEvent.BUTTON3_MASK имеют одинаковые значения, поэтому для обоих модификаторов возвращается строка «Meta».

Обратите внимание, что передавать отрицательное значение параметра некорректно: это приведет к возврату неопределенной строки. Нулевое значение параметра означает, что модификаторы не передавались, и приводит к возврату пустой строки.

Параметры:
modifiers — маска модификаторов, описывающая клавиши-модификаторы и кнопки мыши, нажатые во время события
Возвращает:
строку с текстовым описанием сочетания клавиш-модификаторов и кнопок мыши, нажатых во время события
Начиная с версии:
1.4
См. также:
  • InputEvent.getModifiersExText(int)

paramString

public String paramString()
Возвращает строку параметров, идентифицирующую это событие. Этот метод полезен для ведения журнала событий и отладки.
Переопределяет:
paramString в классе ComponentEvent
Возвращает:
строку, идентифицирующую событие и его атрибуты

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, где представлены более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/event/MouseEvent.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API