Класс MouseWheelEvent

public class MouseWheelEvent
extends MouseEvent

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

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

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

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

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

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

Платформы предоставляют возможность настраивать количество прокрутки, которое должно выполняться при перемещении колеса мыши. Две наиболее распространённые настройки — прокрутка на определённое количество «единиц» (обычно строк текста в текстовом компоненте) или на целый «блок» (аналогично клавишам Page Up/Page Down). MouseWheelEvent предлагает методы для соответствия настройкам базовой платформы. Эти настройки платформы могут быть изменены пользователем в любое время. MouseWheelEvents отражают последние настройки.

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