MouseWheelEvent (Платформа Java SE 7)

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 класс включает методы для того, чтобы получить число "щелчков", на которые поворачивается колесо мыши. getWheelRotation() метод возвращает целое число "щелчков", соответствующих числу меток, на которые было повернуто колесо. В дополнение к этому методу, MouseWheelEvent класс обеспечивает 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` Постоянное представление, прокручивающее "модулями" (как прокрутка с клавишами со стрелками)

Поля 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

Поля 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
источник

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

Конструкторы
Конструктор и Описание
`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()` Возвращает строку параметра, идентифицирующую это событие.

Методы java.awt.event унаследованный от класса. MouseEvent
getButton, getClickCount, getLocationOnScreen, getModifiersEx, getMouseModifiersText, getPoint, getX, getXOnScreen, getY, getYOnScreen, isPopupTrigger, translatePoint

Методы java.awt.event унаследованный от класса. InputEvent
consume, getMaskForButton, getModifiers, 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 унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - WHEEL_UNIT_SCROLL
```
public static final int WHEEL_UNIT_SCROLL
```
    Постоянное представление, прокручивающее "модулями" (как прокрутка с клавишами со стрелками)
    
    См. Также:
    getScrollType(), Постоянные Значения полей
  - WHEEL_BLOCK_SCROLL
```
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, высокий звук, 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, высокий звук, 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, высокий звук, 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 в классе MouseEvent
    
    Возвраты:
    строка, идентифицирующая событие и его атрибуты

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс MouseWheelEvent

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

Поля java.awt.event унаследованный от класса. MouseEvent

Поля java.awt.event унаследованный от класса. InputEvent

Поля java.awt.event унаследованный от класса. ComponentEvent

Поля java.awt унаследованный от класса. AWTEvent

Поля java.util унаследованный от класса. EventObject

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

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

Методы java.awt.event унаследованный от класса. MouseEvent

Методы java.awt.event унаследованный от класса. InputEvent

Методы java.awt.event унаследованный от класса. ComponentEvent

Методы java.awt унаследованный от класса. AWTEvent

Методы java.util унаследованный от класса. EventObject

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

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

WHEEL_UNIT_SCROLL

WHEEL_BLOCK_SCROLL

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

MouseWheelEvent

MouseWheelEvent

MouseWheelEvent

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

getScrollType

getScrollAmount

getWheelRotation

getPreciseWheelRotation

getUnitsToScroll

paramString