Класс MouseWheelEvent

java.awt.event.MouseWheelEvent

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

public class MouseWheelEvent extends MouseEvent

Событие, указывающее, что в компоненте было прокручено колесо мыши.

Мышь с колесом — это мышь, у которой вместо средней кнопки есть колесо. Его можно вращать на себя или от себя. Колесо мыши чаще всего используют для прокрутки, хотя возможны и другие способы применения.

Объект MouseWheelEvent передается каждому объекту MouseWheelListener, зарегистрированному для получения «интересующих» событий мыши с помощью метода addMouseWheelListener компонента. Каждый такой объект-слушатель получает MouseEvent, содержащий событие мыши.

Из-за особой связи колеса мыши с прокруткой компонентов события MouseWheelEvent доставляются несколько иначе, чем другие события MouseEvent. Это связано с тем, что другие события MouseEvent обычно влияют непосредственно на компонент, расположенный под курсором мыши (например, при нажатии кнопки), тогда как события MouseWheelEvent часто влияют на область, удаленную от курсора мыши (вращение колеса над компонентом внутри ScrollPane должно прокручивать одну из полос прокрутки ScrollPane).

Доставка событий MouseWheelEvent начинается с компонента, расположенного под курсором мыши. Если для компонента не включена обработка событий MouseWheelEvent, событие передается первому родительскому контейнеру, для которого такая обработка включена. Обычно это ScrollPane с включенной прокруткой колесом. Исходный компонент и координаты x,y будут заданы относительно конечного адресата события (ScrollPane). Это позволяет без изменений поместить сложный графический интерфейс в ScrollPane и направлять все события MouseWheelEvent в ScrollPane для прокрутки.

Некоторые компоненты AWT реализованы с использованием встроенных виджетов, которые отображают собственные полосы прокрутки и самостоятельно обрабатывают прокрутку. Конкретные компоненты, для которых это справедливо, различаются в зависимости от платформы. Когда колесо мыши прокручивают над одним из таких компонентов, событие передается непосредственно встроенному виджету и не распространяется на родительские компоненты.

Платформы позволяют настроить объем прокрутки при вращении колеса мыши. Два наиболее распространенных варианта — прокрутка заданного числа «единиц» (обычно строк текста в текстовом компоненте) или целого «блока» (аналогично прокрутке на страницу вверх или вниз). Класс MouseWheelEvent предоставляет методы, учитывающие настройки платформы. Пользователь может в любой момент изменить эти настройки. События MouseWheelEvent отражают последние настройки.

Класс MouseWheelEvent содержит методы для получения числа «щелчков», на которое было повернуто колесо мыши. Метод getWheelRotation() возвращает целое число «щелчков», соответствующее числу делений, на которое было повернуто колесо. Помимо этого метода, класс MouseWheelEvent предоставляет метод getPreciseWheelRotation(), возвращающий число «щелчков» типа double, если колесо было повернуто на часть деления. Метод getPreciseWheelRotation() полезен, если мышь поддерживает колесо высокого разрешения, например свободно вращающееся колесо без делений. Приложения могут использовать этот метод для более точной обработки событий прокрутки колесом мыши, обеспечивая тем самым более плавное визуальное восприятие.

Начиная с:

1.4

См. также:

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

Модификатор и тип	Поле	Описание
`static final int`	`WHEEL_BLOCK_SCROLL`	Константа, обозначающая прокрутку на «блок» (например, прокрутку клавишами Page Up и Page Down)
`static final int`	`WHEEL_UNIT_SCROLL`	Константа, обозначающая прокрутку на «единицы» (например, прокрутку клавишами со стрелками)

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

BUTTON1, BUTTON2, BUTTON3, MOUSE_CLICKED, MOUSE_DRAGGED, MOUSE_ENTERED, MOUSE_EXITED, MOUSE_FIRST, MOUSE_LAST, MOUSE_MOVED, MOUSE_PRESSED, MOUSE_RELEASED, MOUSE_WHEEL, NOBUTTON

Модификатор и тип	Поле	Описание
`static final int`	`BUTTON1`	Обозначает кнопку мыши № 1; используется методом `MouseEvent.getButton()`.
`static final int`	`BUTTON2`	Обозначает кнопку мыши № 2; используется методом `MouseEvent.getButton()`.
`static final int`	`BUTTON3`	Обозначает кнопку мыши № 3; используется методом `MouseEvent.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`	Обозначает отсутствие нажатых кнопок мыши; используется методом `MouseEvent.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

Модификатор и тип	Поле	Описание
`static final int`	`ALT_DOWN_MASK`	Расширенная константа-модификатор клавиши Alt.
`static final int`	`ALT_GRAPH_DOWN_MASK`	Расширенная константа-модификатор клавиши AltGraph.
`static final int`	`ALT_GRAPH_MASK`	Устарело. Рекомендуется вместо этого использовать ALT_GRAPH_DOWN_MASK и `InputEvent.getModifiersEx()`
`static final int`	`ALT_MASK`	Устарело. Рекомендуется вместо этого использовать ALT_DOWN_MASK и `InputEvent.getModifiersEx()`
`static final int`	`BUTTON1_DOWN_MASK`	Расширенная константа-модификатор кнопки мыши 1.
`static final int`	`BUTTON1_MASK`	Устарело. Рекомендуется вместо этого использовать BUTTON1_DOWN_MASK и `InputEvent.getModifiersEx()`
`static final int`	`BUTTON2_DOWN_MASK`	Расширенная константа-модификатор кнопки мыши 2.
`static final int`	`BUTTON2_MASK`	Устарело. Рекомендуется вместо этого использовать BUTTON2_DOWN_MASK и `InputEvent.getModifiersEx()`.
`static final int`	`BUTTON3_DOWN_MASK`	Расширенная константа-модификатор кнопки мыши 3.
`static final int`	`BUTTON3_MASK`	Устарело. Рекомендуется вместо этого использовать BUTTON3_DOWN_MASK и `InputEvent.getModifiersEx()`.
`static final int`	`CTRL_DOWN_MASK`	Расширенная константа-модификатор клавиши Control.
`static final int`	`CTRL_MASK`	Устарело. Рекомендуется вместо этого использовать CTRL_DOWN_MASK и `InputEvent.getModifiersEx()`
`static final int`	`META_DOWN_MASK`	Расширенная константа-модификатор клавиши Meta.
`static final int`	`META_MASK`	Устарело. Рекомендуется вместо этого использовать META_DOWN_MASK и `InputEvent.getModifiersEx()`
`static final int`	`SHIFT_DOWN_MASK`	Расширенная константа-модификатор клавиши Shift.
`static final int`	`SHIFT_MASK`	Устарело. Рекомендуется вместо этого использовать SHIFT_DOWN_MASK и `InputEvent.getModifiersEx()`

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

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Модификатор и тип	Поле	Описание
`static final int`	`COMPONENT_FIRST`	Первый номер в диапазоне идентификаторов, используемых для событий компонентов.
`static final int`	`COMPONENT_HIDDEN`	Это событие указывает, что компонент стал невидимым.
`static final int`	`COMPONENT_LAST`	Последний номер в диапазоне идентификаторов, используемых для событий компонентов.
`static final int`	`COMPONENT_MOVED`	Это событие указывает, что положение компонента изменилось.
`static final int`	`COMPONENT_RESIZED`	Это событие указывает, что размер компонента изменился.
`static final int`	`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

Модификатор и тип	Поле	Описание
`static final long`	`ACTION_EVENT_MASK`	Маска событий для выбора событий действий.
`static final long`	`ADJUSTMENT_EVENT_MASK`	Маска событий для выбора событий корректировки.
`static final long`	`COMPONENT_EVENT_MASK`	Маска событий для выбора событий компонентов.
`protected boolean`	`consumed`	Определяет, отправляется ли событие обратно одноранговому объекту после его обработки источником: значение false означает, что оно отправляется одноранговому объекту; значение true — что не отправляется.
`static final long`	`CONTAINER_EVENT_MASK`	Маска событий для выбора событий контейнеров.
`static final long`	`FOCUS_EVENT_MASK`	Маска событий для выбора событий фокуса.
`static final long`	`HIERARCHY_BOUNDS_EVENT_MASK`	Маска событий для выбора событий границ иерархии.
`static final long`	`HIERARCHY_EVENT_MASK`	Маска событий для выбора событий иерархии.
`protected int`	`id`	Идентификатор события.
`static final long`	`INPUT_METHOD_EVENT_MASK`	Маска событий для выбора событий метода ввода.
`static final long`	`INVOCATION_EVENT_MASK`	Маска событий для выбора событий вызова.
`static final long`	`ITEM_EVENT_MASK`	Маска событий для выбора событий элементов.
`static final long`	`KEY_EVENT_MASK`	Маска событий для выбора событий клавиатуры.
`static final long`	`MOUSE_EVENT_MASK`	Маска событий для выбора событий мыши.
`static final long`	`MOUSE_MOTION_EVENT_MASK`	Маска событий для выбора событий движения мыши.
`static final long`	`MOUSE_WHEEL_EVENT_MASK`	Маска событий для выбора событий колеса мыши.
`static final long`	`PAINT_EVENT_MASK`	Маска событий для выбора событий отрисовки.
`static final int`	`RESERVED_ID_MAX`	Максимальное значение зарезервированных идентификаторов событий AWT.
`static final long`	`TEXT_EVENT_MASK`	Маска событий для выбора текстовых событий.
`static final long`	`WINDOW_EVENT_MASK`	Маска событий для выбора событий окон.
`static final long`	`WINDOW_FOCUS_EVENT_MASK`	Маска событий для выбора событий фокуса окна.
`static final long`	`WINDOW_STATE_EVENT_MASK`	Маска событий для выбора событий состояния окна.

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

source

Модификатор и тип	Поле	Описание
`protected Object`	`source`	Объект, в котором изначально произошло событие.

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

Конструктор	Описание
`MouseWheelEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation)`	Создает объект `MouseWheelEvent` с указанными исходным компонентом, типом, модификаторами, координатами, типом прокрутки, величиной прокрутки и поворотом колеса.
`MouseWheelEvent(Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation)`	Создает объект `MouseWheelEvent` с указанными исходным компонентом, типом, модификаторами, координатами, абсолютными координатами, типом прокрутки, величиной прокрутки и поворотом колеса.
`MouseWheelEvent(Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation, double preciseWheelRotation)`	Создает объект `MouseWheelEvent` с указанными исходным компонентом, типом, модификаторами, координатами, абсолютными координатами, типом прокрутки, величиной прокрутки и поворотом колеса.

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

Модификатор и тип	Метод	Описание
`double`	`getPreciseWheelRotation()`	Возвращает количество «щелчков» колёсика мыши в виде числа с плавающей точкой.
`int`	`getScrollAmount()`	Возвращает количество единиц, на которое следует прокручивать содержимое при каждом щелчке колёсика мыши.
`int`	`getScrollType()`	Возвращает тип прокрутки, которая должна выполняться в ответ на это событие.
`int`	`getUnitsToScroll()`	Это вспомогательный метод для реализации распространённого сценария использования MouseWheelListener — прокрутки ScrollPane или JScrollPane на величину, соответствующую настройкам платформы.
`int`	`getWheelRotation()`	Возвращает количество «щелчков» колёсика мыши в виде целого числа.
`String`	`paramString()`	Возвращает строку параметров, идентифицирующую это событие.

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

getButton, getClickCount, getLocationOnScreen, getMouseModifiersText, getPoint, getX, getXOnScreen, getY, getYOnScreen, isPopupTrigger, translatePoint

Модификатор и тип	Метод	Описание
`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()`	Возвращает сведения о том, является ли это событие мыши событием вызова всплывающего меню для данной платформы.
`void`	`translatePoint(int x, int y)`	Перемещает координаты события в новую позицию, добавляя указанные смещения `x` (по горизонтали) и `y` (по вертикали).

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

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

Модификатор и тип	Метод	Описание
`void`	`consume()`	Потребляет это событие, чтобы оно не обрабатывалось обычным образом источником, который его создал.
`static int`	`getMaskForButton(int button)`	Метод для получения маски любой существующей кнопки мыши.
`int`	`getModifiers()`	Устарело. Рекомендуется использовать расширенные клавиши-модификаторы и `InputEvent.getModifiersEx()`
`int`	`getModifiersEx()`	Возвращает расширенную маску модификаторов для этого события.
`static String`	`getModifiersExText(int modifiers)`	Возвращает строку с описанием расширенных клавиш-модификаторов и кнопок мыши, например «Shift», «Button1» или «Ctrl+Shift».
`long`	`getWhen()`	Возвращает разницу в миллисекундах между временной меткой события и полуночью 1 января 1970 года по UTC.
`boolean`	`isAltDown()`	Возвращает сведения о том, нажата ли клавиша-модификатор Alt для этого события.
`boolean`	`isAltGraphDown()`	Возвращает сведения о том, нажата ли клавиша-модификатор AltGraph для этого события.
`boolean`	`isConsumed()`	Возвращает сведения о том, было ли это событие потреблено.
`boolean`	`isControlDown()`	Возвращает сведения о том, нажата ли клавиша-модификатор Control для этого события.
`boolean`	`isMetaDown()`	Возвращает сведения о том, нажата ли клавиша-модификатор Meta для этого события.
`boolean`	`isShiftDown()`	Возвращает сведения о том, нажата ли клавиша-модификатор Shift для этого события.

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

getComponent

Модификатор и тип	Метод	Описание
`Component`	`getComponent()`	Возвращает источник события.

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

getID, setSource, toString

Модификатор и тип	Метод	Описание
`int`	`getID()`	Возвращает тип события.
`void`	`setSource(Object newSource)`	Перенаправляет событие к новому источнику.
`String`	`toString()`	Возвращает строковое представление этого объекта.

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

getSource

Модификатор и тип	Метод	Описание
`Object`	`getSource()`	Объект, на котором первоначально произошло событие.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

WHEEL_UNIT_SCROLL

@Native public static final int WHEEL_UNIT_SCROLL

Константа, обозначающая прокрутку на «единицы» (например, прокрутку клавишами со стрелками)

См. также:

WHEEL_BLOCK_SCROLL

@Native public static final int WHEEL_BLOCK_SCROLL

Константа, обозначающая прокрутку на «блок» (например, прокрутку клавишами Page Up и Page Down)

См. также:

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

MouseWheelEvent

public MouseWheelEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation)

Создает объект MouseWheelEvent с указанными исходным компонентом, типом, модификаторами, координатами, типом прокрутки, величиной прокрутки и вращением колеса.

Абсолютные координаты xAbs и yAbs устанавливаются в соответствии с положением источника на экране плюс относительные координаты x и y. Если источник не отображается, xAbs и yAbs устанавливаются в ноль.

Обратите внимание, что передача недопустимого значения id приводит к неопределенному поведению. Этот метод выбрасывает IllegalArgumentException, если source равно null.

Параметры:

source — Component, вызвавший событие

id — целое число, идентифицирующее событие

when — значение типа long, задающее время возникновения события

modifiers — клавиши-модификаторы, нажатые во время события (shift, ctrl, alt, meta)

x — горизонтальная координата x положения мыши

y — вертикальная координата y положения мыши

clickCount — количество щелчков мышью, связанных с событием

popupTrigger — логическое значение: true, если это событие вызывает отображение всплывающего меню

scrollType — тип прокрутки, которая должна выполняться в ответ на это событие; допустимые значения: WHEEL_UNIT_SCROLL и WHEEL_BLOCK_SCROLL

scrollAmount — для scrollType WHEEL_UNIT_SCROLL количество прокручиваемых единиц

wheelRotation — целое число «щелчков», на которые было повернуто колесо мыши

Исключения:

IllegalArgumentException — если source имеет значение null

См. также:

MouseWheelEvent

public MouseWheelEvent(Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation)

Создает объект MouseWheelEvent с указанными исходным компонентом, типом, модификаторами, координатами, абсолютными координатами, типом прокрутки, величиной прокрутки и вращением колеса.

Даже если конструктору переданы несогласованные значения относительных и абсолютных координат, экземпляр MouseWheelEvent все равно создается, и исключение не выбрасывается.

Параметры:

source — Component, вызвавший событие

id — целое число, идентифицирующее событие

when — значение типа long, задающее время возникновения события

modifiers — клавиши-модификаторы, нажатые во время события (shift, ctrl, alt, meta)

x — горизонтальная координата x положения мыши

y — вертикальная координата y положения мыши

xAbs — абсолютная горизонтальная координата x положения мыши

yAbs — абсолютная вертикальная координата y положения мыши

clickCount — количество щелчков мышью, связанных с событием

popupTrigger — логическое значение: true, если это событие вызывает отображение всплывающего меню

scrollAmount — для scrollType WHEEL_UNIT_SCROLL количество прокручиваемых единиц

wheelRotation — целое число «щелчков», на которые было повернуто колесо мыши

Исключения:

IllegalArgumentException — если source имеет значение null

Начиная с версии:

1.6

См. также:

MouseWheelEvent

public MouseWheelEvent(Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation, double preciseWheelRotation)

Обратите внимание, что передача недопустимого параметра id приводит к неопределенному поведению. Этот метод выбрасывает IllegalArgumentException, если source равно null.

Даже если конструктору переданы несогласованные значения относительных и абсолютных координат, экземпляр MouseWheelEvent все равно создается, и исключение не выбрасывается.

Параметры:

source — Component, вызвавший событие

id — целочисленное значение, идентифицирующее событие

when — значение типа long, задающее время возникновения события

modifiers — клавиши-модификаторы, нажатые во время события (shift, ctrl, alt, meta)

x — горизонтальная координата x положения мыши

y — вертикальная координата y положения мыши

xAbs — абсолютная горизонтальная координата x положения мыши

yAbs — абсолютная вертикальная координата y положения мыши

clickCount — количество щелчков мышью, связанных с событием

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

scrollAmount — для scrollType WHEEL_UNIT_SCROLL количество прокручиваемых единиц

wheelRotation — целое число «щелчков», на которые было повернуто колесо мыши

preciseWheelRotation — число с плавающей точкой двойной точности, обозначающее количество «щелчков», на которые было повернуто колесо мыши

Исключения:

IllegalArgumentException — если source имеет значение null

Начиная с версии:

1.7

См. также:

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

getScrollType

public int getScrollType()

Возвращает тип прокрутки, которая должна выполняться в ответ на это событие. Он определяется нативной платформой. Допустимые значения:

MouseWheelEvent.WHEEL_UNIT_SCROLL
MouseWheelEvent.WHEEL_BLOCK_SCROLL

Возвращает:

MouseWheelEvent.WHEEL_UNIT_SCROLL или MouseWheelEvent.WHEEL_BLOCK_SCROLL в зависимости от конфигурации нативной платформы.

См. также:

getScrollAmount

public int getScrollAmount()

Возвращает количество единиц, на которое следует прокручивать при каждом щелчке колеса мыши. Имеет смысл только если getScrollType возвращает MouseWheelEvent.WHEEL_UNIT_SCROLL

Возвращает:

количество прокручиваемых единиц или неопределенное значение, если getScrollType возвращает MouseWheelEvent.WHEEL_BLOCK_SCROLL

См. также:

getWheelRotation

public int getWheelRotation()

Возвращает целое число «щелчков», на которые было повернуто колесо мыши. Если мышь поддерживает колесо высокого разрешения, возможно частичное вращение. В этом случае метод возвращает ноль, пока не будет накоплен полный «щелчок».

Возвращает:

отрицательные значения, если колесо мыши повернуто вверх/от пользователя, и положительные значения, если колесо мыши повернуто вниз/к пользователю

См. также:

getPreciseWheelRotation

public double getPreciseWheelRotation()

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

Возвращает:

отрицательные значения, если колесо мыши повернуто вверх или от пользователя, и положительные значения, если колесо мыши повернуто вниз или к пользователю

Начиная с версии:

1.7

См. также:

getUnitsToScroll

public int getUnitsToScroll()

Это вспомогательный метод, упрощающий реализацию распространенного случая использования MouseWheelListener — прокрутки ScrollPane или JScrollPane на величину, соответствующую настройкам платформы. (Однако обратите внимание, что ScrollPane и JScrollPane уже имеют эту встроенную функциональность.)

Этот метод возвращает количество единиц прокрутки, если тип прокрутки — MouseWheelEvent.WHEEL_UNIT_SCROLL, и его следует вызывать только в том случае, если getScrollType возвращает MouseWheelEvent.WHEEL_UNIT_SCROLL.

Учитываются направление прокрутки, величина поворота колеса и настройки прокрутки колесом на платформе. Этот метод не учитывает и не может учитывать значение приращения единицы Adjustable/Scrollable, поскольку оно различается для разных компонентов прокрутки.

Упрощенный пример использования этого метода в обработчике:

 mouseWheelMoved(MouseWheelEvent event) {
     ScrollPane sp = getScrollPaneFromSomewhere();
     Adjustable adj = sp.getVAdjustable()
     if (MouseWheelEvent.getScrollType() == WHEEL_UNIT_SCROLL) {
         int totalScrollAmount =
             event.getUnitsToScroll() *
             adj.getUnitIncrement();
         adj.setValue(adj.getValue() + totalScrollAmount);
     }
 }

Возвращает:

количество единиц прокрутки с учетом направления и величины поворота колеса мыши, а также настроек прокрутки колесом нативной платформы

См. также:

paramString

public String paramString()

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

Переопределяет:: paramString в классе MouseEvent
Возвращает:: строку, идентифицирующую событие и его атрибуты

© 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.