java.awt.event

Класс MouseEvent

java.lang. Объект

java.util. EventObject

java.awt. AWTEvent

java.awt.event. ComponentEvent

java.awt.event. InputEvent

java.awt.event. MouseEvent

Все Реализованные Интерфейсы:

Сериализуемый

Прямые Известные Подклассы:

MenuDragMouseEvent, MouseWheelEvent

public class MouseEvent
extends InputEvent

Событие, которое указывает, что действие мыши произошло в компоненте. Действие мыши, как полагают, происходит в определенном компоненте, если и только если курсор мыши по незатененной части границ компонента, когда действие происходит. Для легких компонентов, таких как компоненты Swing, события от нажатия мыши только диспетчеризируются компоненту, если тип события от нажатия мыши был включен на компоненте. Тип события от нажатия мыши включается, добавляя соответствующее основанное на мыши EventListener к компоненту (MouseListener или MouseMotionListener), или вызывая Component.enableEvents(long) с соответствующим параметром маски (AWTEvent.MOUSE_EVENT_MASK или AWTEvent.MOUSE_MOTION_EVENT_MASK). Если тип события от нажатия мыши не был включен на компоненте, соответствующие события от нажатия мыши диспетчеризируются первому предку, который включил типу события от нажатия мыши.

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

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

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

A MouseEvent объект передают к каждому MouseListener или MouseAdapter объект, который регистрируется, чтобы получить "интересные" события от нажатия мыши, используя компонент addMouseListener метод. (MouseAdapter объекты реализуют MouseListener интерфейс.) Каждый такой объект слушателя получает a MouseEvent содержа событие от нажатия мыши.

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

Когда кнопкой мыши щелкают, события сгенерированы и отправлены зарегистрированному MouseListeners. Состояние модальных ключей может быть получено, используя 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

См. Также:

MouseAdapter, MouseListener, MouseMotionAdapter, MouseMotionListener, MouseWheelListener, Учебное руководство: Пишущий Слушателю Мыши, Учебному руководству: Запись Слушателя Движения Мыши, Сериализированной Формы

Полевая Сводка

Поля

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

Поля, наследованные от class 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

Поля, наследованные от class java.awt.event. ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Поля, наследованные от class 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

Поля, наследованные от class java.util. EventObject

источник

Сводка конструктора

Конструкторы

Конструктор и Описание
MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger) Конструкции a MouseEvent объект с указанным исходным компонентом, типом, модификаторами, координатами, щелкает по количеству, и флагу popupTrigger.
MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int button) Конструкции a 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) Конструкции a MouseEvent объект с указанным исходным компонентом, типом, время, модификаторы, координаты, абсолютные координаты, щелкает по количеству, popupTrigger флаг, и число кнопки.

Сводка метода

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

Методы, наследованные от class java.awt.event. InputEvent

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

Методы, наследованные от class java.awt.event. ComponentEvent

getComponent

Методы, наследованные от class java.awt. AWTEvent

getID, setSource, toString

Методы, наследованные от class java.util. EventObject

getSource

Методы, наследованные от class java.lang. Объект

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)

Конструкции a MouseEvent объект с указанным исходным компонентом, типом, время, модификаторы, координаты, щелкает по количеству, popupTrigger флаг, и число кнопки.

Создание недопустимого события (такой как при использовании больше чем одного из старых _MASKs, или значений модификатора/кнопки, которые не соответствуют), результаты в неуказанном поведении. Вызов формы 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 - Целое число, указывающее на тип события. Для получения информации о допустимых значениях см. описание class для MouseEvent

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

modifiers - маска модификатора, описывающая модифицирующие клавиши и кнопки мыши (например, сдвиг, ctrl, alt, и meta), которые снижаются во время события. Только расширенным модификаторам позволяют использоваться в качестве значения для этого параметра (см. InputEvent.getModifiersEx() class для описания расширенных модификаторов). Передача отрицательного параметра не рекомендуется. Нулевое значение означает, что никакие модификаторы не передали

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 нуль

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

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

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

IllegalArgumentException - если source нуль

С тех пор:

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)

Конструкции a 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 - Целое число, указывающее на тип события. Для получения информации о допустимых значениях см. описание class для MouseEvent

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

modifiers - маска модификатора, описывающая модифицирующие клавиши и кнопки мыши (например, сдвиг, ctrl, alt, и meta), которые снижаются во время события. Только расширенным модификаторам позволяют использоваться в качестве значения для этого параметра (см. InputEvent.getModifiersEx() class для описания расширенных модификаторов). Передача отрицательного параметра не рекомендуется. Нулевое значение означает, что никакие модификаторы не передали

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

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

clickCount - Число щелчков мышью связалось с событием. Передача отрицательной величины не рекомендуется

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

Броски:

IllegalArgumentException - если source нуль

См. Также:

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)

Конструкции a MouseEvent объект с указанным исходным компонентом, типом, время, модификаторы, координаты, абсолютные координаты, щелкает по количеству, popupTrigger флаг, и число кнопки.

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

Параметры:

source - Component это породило событие

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

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

modifiers - маска модификатора, описывающая модифицирующие клавиши и кнопки мыши (например, сдвиг, ctrl, alt, и meta), которые снижаются во время события. Только расширенным модификаторам позволяют использоваться в качестве значения для этого параметра (см. InputEvent.getModifiersEx() class для описания расширенных модификаторов). Передача отрицательного параметра не рекомендуется. Нулевое значение означает, что никакие модификаторы не передали

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() если у мыши есть больше чем три кнопки.

Броски:

IllegalArgumentException - если button менее тогда нуль

IllegalArgumentException - если source нуль

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

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

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

IllegalArgumentException - если source нуль

С тех пор:

1.6

См. Также:

EventObject.getSource(), AWTEvent.getID(), InputEvent.getWhen(), InputEvent.getModifiers(), getX(), getY(), getXOnScreen(), getYOnScreen(), getClickCount(), isPopupTrigger(), getButton(), button, Toolkit.areExtraMouseButtonsEnabled(), MouseInfo.getNumberOfButtons(), InputEvent.getMaskForButton(int)

Деталь метода

getLocationOnScreen

public Point getLocationOnScreen()

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

Возвраты:

a 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

getModifiersEx

public int getModifiersEx()

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

Расширенные модификаторы являются модификаторами, который заканчивается суффиксом _DOWN_MASK, таким как ALT_DOWN_MASK, BUTTON1_DOWN_MASK, и другие.

Расширенные модификаторы представляют состояние всех модальных ключей, таких как ALT, CTRL, МЕТА, и кнопки мыши сразу после того, как событие имело место.

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

    MOUSE_PRESSED:  BUTTON1_DOWN_MASK
    MOUSE_PRESSED:  BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASK
    MOUSE_RELEASED: BUTTON2_DOWN_MASK
    MOUSE_CLICKED:  BUTTON2_DOWN_MASK
    MOUSE_RELEASED:
    MOUSE_CLICKED:
 

Не рекомендуется сравнить возвращаемое значение этого использования метода == потому что новые модификаторы могут быть добавлены в будущем. Например, соответствующий способ проверить, что SHIFT и BUTTON1 снижаются, но CTRL, произошел, демонстрируется следующим кодом:

    int onmask = SHIFT_DOWN_MASK | BUTTON1_DOWN_MASK;
    int offmask = CTRL_DOWN_MASK;
    if ((event.getModifiersEx() & (onmask | offmask)) == onmask) {
        ...
    }
 

Вышеупомянутый код будет работать, даже если будут добавлены новые модификаторы.

Переопределения:

getModifiersEx в class InputEvent

getX

public int getX()

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

Возвраты:

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

getY

public int getY()

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

Возвраты:

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

getPoint

public Point getPoint()

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

Возвраты:

a 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

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

Возвраты:

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

С тех пор:

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()

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

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

Возвраты:

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

getMouseModifiersText

public static String getMouseModifiersText(int modifiers)

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

Отметьте что InputEvent.ALT_MASK и InputEvent.BUTTON2_MASK имейте равные значения, таким образом, строка "Высокого звука" возвращается для обоих модификаторов. Аналогично, InputEvent.META_MASK и InputEvent.BUTTON3_MASK имейте равные значения, таким образом, строка "Меты" возвращается для обоих модификаторов.

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

Параметры:

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

Возвраты:

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

С тех пор:

1.4

См. Также:

InputEvent.getModifiersExText(int)

paramString

public String paramString()

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

Переопределения:

paramString в class ComponentEvent

Возвраты:

строка, идентифицирующая событие и его атрибуты