java.awt.event

Класс MouseWheelEvent

java.lang. Объект

java.util. EventObject

java.awt. AWTEvent

java.awt.event. ComponentEvent

java.awt.event. InputEvent

java.awt.event. MouseEvent

java.awt.event. MouseWheelEvent

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

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

public class MouseWheelEvent
extends MouseEvent

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

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

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

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

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

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

Платформы предлагают настройку количества прокрутки, которая должна иметь место, когда колесо мыши перемещается. Две наиболее распространенных настройки должны прокрутить определенное число "модулей" (обычно строки текста в основанном на тексте компоненте) или весь "блок" (подобный page-up/page-down). MouseWheelEvent предлагает методы для того, чтобы соответствовать базовым настройкам платформы. Эти настройки платформы могут быть изменены в любое время пользователем. MouseWheelEvents отражают новые настройки.

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

С тех пор:

1.4

См. Также:

MouseWheelListener, ScrollPane, ScrollPane.setWheelScrollingEnabled(boolean), JScrollPane, JScrollPane.setWheelScrollingEnabled(boolean), Сериализированная Форма

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

Поля

Модификатор и Тип	Поле и Описание
static int	WHEEL_BLOCK_SCROLL Постоянное представление, прокручивающее "блоком" (как прокрутка со страницей, клавишами Page Down)
static int	WHEEL_UNIT_SCROLL Постоянное представление, прокручивающее "модулями" (как прокрутка с клавишами со стрелками)

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

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

источник

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

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

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

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

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

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

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

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

Полевая Деталь

WHEEL_UNIT_SCROLL

@Native
public static final int WHEEL_UNIT_SCROLL

Постоянное представление, прокручивающее "модулями" (как прокрутка с клавишами со стрелками)

См. Также:

getScrollType(), Постоянные Значения полей

WHEEL_BLOCK_SCROLL

@Native
public static final int WHEEL_BLOCK_SCROLL

Постоянное представление, прокручивающее "блоком" (как прокрутка со страницей, клавишами Page Down)

См. Также:

getScrollType(), Постоянные Значения полей

Деталь конструктора

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)

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

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

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

Параметры:

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

id - целое число, которое идентифицирует событие

when - произошло длинное, которое дает времени событие,

modifiers - модифицирующие клавиши вниз во время события (сдвиг, ctrl, alt, meta)

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

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

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

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

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

scrollAmount - для scrollType WHEEL_UNIT_SCROLL, число модулей, которые будут прокручены

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

Броски:

IllegalArgumentException - если source нуль

См. Также:

MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean), MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)

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)

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

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

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

Параметры:

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

id - целое число, которое идентифицирует событие

when - произошло длинное, которое дает времени событие,

modifiers - модифицирующие клавиши вниз во время события (сдвиг, ctrl, alt, meta)

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

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

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

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

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

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

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

scrollAmount - для scrollType WHEEL_UNIT_SCROLL, число модулей, которые будут прокручены

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

Броски:

IllegalArgumentException - если source нуль

С тех пор:

1.6

См. Также:

MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean), MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)

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)

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

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

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

Параметры:

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

id - целочисленное значение, которое идентифицирует событие

when - длинное значение, которое дает время, когда событие имело место

modifiers - модифицирующие клавиши вниз во время события (сдвиг, ctrl, alt, meta)

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

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

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

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

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

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

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

scrollAmount - для scrollType WHEEL_UNIT_SCROLL, число модулей, которые будут прокручены

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

preciseWheelRotation - двойное число "щелчков", на которые было повернуто колесо мыши

Броски:

IllegalArgumentException - если source нуль

С тех пор:

1.7

См. Также:

MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean), MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)

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

getScrollType

public int getScrollType()

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

• MouseWheelEvent. WHEEL_UNIT_SCROLL
• MouseWheelEvent. WHEEL_BLOCK_SCROLL

Возвраты:

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

См. Также:

Adjustable.getUnitIncrement(), Adjustable.getBlockIncrement(), Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int), Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)

getScrollAmount

public int getScrollAmount()

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

Возвраты:

число модулей, чтобы прокрутить, или неопределенное значение, если getScrollType возвраты MouseWheelEvent.WHEEL_BLOCK_SCROLL

См. Также:

getScrollType()

getWheelRotation

public int getWheelRotation()

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

Возвраты:

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

См. Также:

getPreciseWheelRotation()

getPreciseWheelRotation

public double getPreciseWheelRotation()

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

Возвраты:

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

С тех пор:

1.7

См. Также:

getWheelRotation()

getUnitsToScroll

public int getUnitsToScroll()

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

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

Направление прокрутки, количество перемещения колеса, и настроек платформы для колеса, прокручивающего, все учитываются. Этот метод не делает и не может принять во внимание значение Корректируемого/С возможностью прокрутки инкремента модуля, поскольку это изменится среди прокрутки компонентов.

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

  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);
      }
  }
 

Возвраты:

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

См. Также:

getScrollType(), getScrollAmount(), MouseWheelListener, Adjustable, Adjustable.getUnitIncrement(), Scrollable, Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int), ScrollPane, ScrollPane.setWheelScrollingEnabled(boolean), JScrollPane, JScrollPane.setWheelScrollingEnabled(boolean)

paramString

public String paramString()

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

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

paramString в class MouseEvent

Возвраты:

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