Класс MouseEvent

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). Из-за платформенно-зависимых реализаций Drag&Drop, события MOUSE_DRAGGED могут не доставляться во время собственного процесса Drag&Drop. В многоэкранной среде события перетаскивания мыши доставляются в Component, даже если позиция мыши находится за пределами границ GraphicsConfiguration, связанной с этим Component. Однако, отчётная позиция для событий перетаскивания мыши в этом случае может отличаться от фактической позиции мыши:

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

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

С тех пор как:

1.1

См. также:

END_OF_DOCUMENT_MARKER

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

Модификатор и тип	Поле	Описание
`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()`.

Поля, объявленные в классе java.awt.event.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

Поля, объявленные в классе java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Поля, объявленные в классе java.awt.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

Поля, объявленные в классе java.util.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` (вертикальное).

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

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

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

getComponent

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

getID, setSource, toString

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

getSource

Методы, объявленные в классе java.lang.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

См. также:

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

END_OF_DOCUMENT_MARKER

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 - Компонент, являющийся источником события

id - Целое число, указывающее тип события. Справочную информацию о допустимых значениях см. в описании класса MouseEvent

when - Длинное целое число, представляющее время возникновения события. Передача отрицательного или нулевого значения не рекомендуется

modifiers - Маска модификаторов, описывающая нажатые клавиши модификаторов и кнопки мыши (например, Shift, Ctrl, Alt и Meta) во время события. Допускается использовать только расширенные модификаторы (см. класс InputEvent.getModifiersEx() для описания расширенных модификаторов). Передача отрицательного параметра не рекомендуется. Нулевое значение означает, что модификаторы не передавались

x - Горизонтальная координата x для положения мыши. Разрешается передавать отрицательные значения

y - Вертикальная координата y для положения мыши. Разрешается передавать отрицательные значения

clickCount - Количество щелчков мыши, связанных с событием. Передача отрицательного значения не рекомендуется

popupTrigger - Логическое значение, равное true, если это событие является триггером для всплывающего меню

button - Целое число, указывающее, какая кнопка мыши изменила своё состояние. Применяются следующие правила к этому параметру:

Если поддержка расширенных кнопок мыши disabled в Java, то разрешается создавать объекты MouseEvent только со стандартными кнопками: NOBUTTON, BUTTON1, BUTTON2 и BUTTON3.
Если поддержка расширенных кнопок мыши enabled в Java, то разрешается создавать объекты MouseEvent со стандартными кнопками. В случае, если поддержка расширенных кнопок мыши enabled в Java, то помимо стандартных кнопок, объекты MouseEvent могут быть созданы, используя кнопки из диапазона от 4 до MouseInfo.getNumberOfButtons(), если у мыши больше трёх кнопок.

Исключения:

IllegalArgumentException - если button меньше нуля

IllegalArgumentException - если source равно null

IllegalArgumentException - если button больше BUTTON3, а поддержка расширенных кнопок мыши disabled в Java

IllegalArgumentException - если button больше current number of buttons, а поддержка расширенных кнопок мыши enabled в Java

IllegalArgumentException - если передано недопустимое значение button

IllegalArgumentException - если source равно null

С тех пор:

1.4

См. также:

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 - Компонент, являющийся источником события

x - Горизонтальная координата x для положения мыши. Разрешается передавать отрицательные значения

y - Вертикальная координата y для положения мыши. Разрешается передавать отрицательные значения

clickCount - Количество щелчков мыши, связанных с событием. Передача отрицательного значения не рекомендуется

popupTrigger - Логическое значение, равное true, если это событие является триггером для всплывающего меню

Исключения:

IllegalArgumentException - если source равно null

См. также:

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.

Parameters:

source - Компонент, который породил событие

when - Длинное целое число, задающее время возникновения события. Передача отрицательного или нулевого значения не рекомендуется

modifiers - Маска модификаторов, описывающая нажатые клавиши и кнопки мыши (например, Shift, Ctrl, Alt и Meta) во время события. Для этого параметра допускается использование только расширенных модификаторов (см. описание расширенных модификаторов в классе InputEvent.getModifiersEx()). Передача отрицательного параметра не рекомендуется. Нулевое значение означает, что модификаторы не были переданы

x - Горизонтальная координата x для расположения указателя мыши. Допускается передача отрицательных значений

y - Вертикальная координата y для расположения указателя мыши. Допускается передача отрицательных значений

xAbs - Абсолютная горизонтальная координата x для расположения указателя мыши. Допускается передача отрицательных значений

yAbs - Абсолютная вертикальная координата y для расположения указателя мыши. Допускается передача отрицательных значений

clickCount - Количество кликов мышью, связанных с событием. Передача отрицательного значения не рекомендуется

popupTrigger - Логическое значение, равное true, если это событие является триггером для всплывающего меню

button - Целое число, указывающее, какая из кнопок мыши изменила своё состояние. Применяются следующие правила к этому параметру:

Если поддержка расширенных кнопок мыши disabled в Java, то разрешается создавать объекты MouseEvent только со стандартными кнопками: NOBUTTON, BUTTON1, BUTTON2 и BUTTON3.
Если поддержка расширенных кнопок мыши enabled в Java, то разрешается создавать объекты MouseEvent со стандартными кнопками. В случае, если поддержка расширенных кнопок мыши enabled в Java, то помимо стандартных кнопок объекты MouseEvent могут быть созданы с использованием кнопок из диапазона, начиная с 4 до MouseInfo.getNumberOfButtons(), если у мыши более трёх кнопок.

Throws:

IllegalArgumentException - если button меньше нуля

IllegalArgumentException - если source равно null

IllegalArgumentException - если button больше, чем BUTTON3, а поддержка расширенных кнопок мыши disabled в Java

IllegalArgumentException - если button больше, чем current number of buttons, а поддержка расширенных кнопок мыши enabled в Java

IllegalArgumentException - если передано некорректное значение button

IllegalArgumentException - если source равно null

Since:

1.6

See Also:

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

getLocationOnScreen

public Point getLocationOnScreen()

Возвращает абсолютные координаты x и y события. В среде виртуального устройства с несколькими экранами, где область рабочего стола может охватывать несколько физических экранов, эти координаты относительны к виртуальной системе координат. В противном случае эти координаты относительны к системе координат, связанной с GraphicsConfiguration компонента.

Returns:

объект Point, содержащий абсолютные координаты x и y.

Since:

1.6

See Also:

getXOnScreen

public int getXOnScreen()

Возвращает абсолютную горизонтальную координату x события. В среде виртуального устройства с несколькими экранами, где область рабочего стола может охватывать несколько физических экранов, эта координата относительна к виртуальной системе координат. В противном случае эта координата относительна к системе координат, связанной с GraphicsConfiguration компонента.

Returns:

целое число x, указывающее абсолютное горизонтальное положение.

Since:

1.6

See Also:

getYOnScreen

public int getYOnScreen()

Возвращает абсолютную вертикальную координату y события. В среде виртуального устройства с несколькими экранами, где область рабочего стола может охватывать несколько физических экранов, эта координата относительна к виртуальной системе координат. В противном случае эта координата относительна к системе координат, связанной с GraphicsConfiguration компонента.

Returns:

целое число y, указывающее абсолютное вертикальное положение.

Since:

1.6

See Also:

getX

public int getX()

Возвращает горизонтальную координату x события относительно исходного компонента.

Returns:: целое число x, указывающее горизонтальное положение относительно компонента

getY

public int getY()

Возвращает вертикальную координату y события относительно исходного компонента.

Returns:: целое число y, указывающее вертикальное положение относительно компонента

getPoint

public Point getPoint()

Возвращает координаты x,y события относительно исходного компонента.

Returns:: объект Point, содержащий координаты x и y, относительные к исходному компоненту

translatePoint

public void translatePoint(int x, int y)

Перемещает координаты события в новое положение, добавив указанные смещения по оси x (горизонталь) и y (вертикаль).

Parameters:: x - горизонтальное значение x, которое нужно добавить к текущей координате x; y - вертикальное значение y, которое нужно добавить к текущей координате y

getClickCount

public int getClickCount()

Возвращает количество кликов мышью, связанных с этим событием.

Returns:: целое значение для количества кликов

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

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

Returns:

одно из значений от 0 до MouseInfo.getNumberOfButtons(), если поддержка дополнительных кнопок мыши enabled в Java. Этот диапазон включает NOBUTTON, BUTTON1, BUTTON2, BUTTON3;
NOBUTTON, BUTTON1, BUTTON2 или BUTTON3, если поддержка дополнительных кнопок мыши disabled в Java

Since:

1.4

See Also:

isPopupTrigger

public boolean isPopupTrigger()

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

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

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

getMouseModifiersText

public static String getMouseModifiersText(int modifiers)

Возвращает строку, описывающую нажатые модификаторы клавиш и кнопки мыши во время события, например, "Shift" или "Ctrl+Shift". Эти строки можно локализовать, изменив файл awt.properties.

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

Обратите внимание, что передача отрицательного параметра является некорректной и приведёт к возвращению неопределённой строки. Параметр ноль означает, что модификаторы не были переданы, и это приведёт к возвращению пустой строки.

Parameters:

modifiers - Маска модификаторов, описывающая нажатые клавиши модификаторов и кнопки мыши во время события

Returns:

строка, описывающая комбинацию клавиш модификаторов и кнопок мыши, нажатых во время события

Since:

1.4

See Also:

paramString

public String paramString()

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

Overrides:: paramString в классе ComponentEvent
Returns:: строка, идентифицирующая событие и его атрибуты

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/event/MouseEvent.html