java.awt.event

Class MouseWheelEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.ComponentEvent

java.awt.event.InputEvent

java.awt.event.MouseEvent

java.awt.event.MouseWheelEvent

All Implemented Interfaces:

Serializable

public class MouseWheelEvent
extends MouseEvent

一个事件，这表明鼠标滚轮在一个组件中旋转。

车轮鼠标是一种鼠标，它有一个轮子代替中间按钮。这个轮子可以旋转向或远离用户。鼠标滚轮是最常用的滚动，虽然其他用途是可能的。

一个mousewheelevent对象传递给每一MouseWheelListener对象注册接收使用组件的addMouseWheelListener方法“有趣”的鼠标事件。每一个这样的听众对象获取一个MouseEvent包含鼠标事件。

由于鼠标滚轮滚动组件之间的特殊关系，mousewheelevents交付比其他鼠标事件来有所不同。这是因为当其他鼠标事件来影响改变通常直接在鼠标光标的组件（例如，点击一个按钮时），MouseWheelEvents经常有效果离鼠标光标（移动轮，在滚动窗格组件应该滚动一对滚动窗格滚动条）。

mousewheelevents开始交付从下面的鼠标光标的成分。如果mousewheelevents不在组件启用，事件传递到始祖容器mousewheelevents启用。这通常是一个车轮滚动启用滚动窗格。源组件和x，y坐标是相对于事件的最终目的地（的滚动窗格）。这使得复杂的GUI安装无改成滚动窗格，和所有mousewheelevents送到滚动窗格滚动。

一些AWT组件使用本地窗口显示自己的滚动条实现和处理自己的滚动。这是真正的特定组件将有所不同，从平台到平台。当鼠标滚轮移动到这些组件中的一个时，事件将直接传递到本机部件，而不会传播到祖先。

平台提供定制的滚动，应该发生时，鼠标滚轮移动的数量。最常见的两种设置滚动一定数量的“单位”（通常在一个文本组件的文本行）或者一个完整的“块”（类似于上一页/下一页）。的mousewheelevent顺应底层平台的设置提供了方法。这些平台设置可以在任何时间由用户更改。mousewheelevents反映最新的设置。

MouseWheelEvent类包含的方法得到“点击”的旋转鼠标滚轮的数量。的getWheelRotation()方法返回整数的“点击”对应缺口的车轮旋转。除了这种方法，该MouseWheelEvent类提供getPreciseWheelRotation()方法返回一个双精度数的“点击”的情况下，部分发生转动。如果鼠标支持高分辨率的轮getPreciseWheelRotation()方法是有用的，如可自由旋转的车轮没有缺口。应用程序可以受益于使用这种方法来处理鼠标滚轮事件更精确，因此，使视觉感知更流畅。

从以下版本开始：

一点四

另请参见：

MouseWheelListener， ScrollPane， ScrollPane.setWheelScrollingEnabled(boolean)， JScrollPane， JScrollPane.setWheelScrollingEnabled(boolean)， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	WHEEL_BLOCK_SCROLL 常量代表滚动的一个“块”（如滚动页面上，页下键）
static int	WHEEL_UNIT_SCROLL 常量表示“单位”滚动（如用箭头键滚动）

Fields inherited from 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

Fields inherited from 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

Fields inherited from class java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Fields inherited from 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

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
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对象类型、修饰符、坐标，绝对坐标，涡旋，涡旋的数量，和车轮的转动。

方法摘要

Modifier and Type	Method and Description
double	getPreciseWheelRotation() 返回鼠标滚轮被旋转的“点击次数”，作为一个双。
int	getScrollAmount() 返回单位，应滚动鼠标滚轮旋转每点击数。
int	getScrollType() 返回应该发生在响应此事件时的滚动类型。
int	getUnitsToScroll() 这是一个方便的方法来帮助在一般情况下，MouseWheelListener -实施量符合平台设置滚动滚动窗格或JScrollPane。
int	getWheelRotation() 返回鼠标滚轮的“点击次数”，作为一个整数。
String	paramString() 返回标识此事件的参数字符串。

Methods inherited from class java.awt.event.MouseEvent

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

Methods inherited from class java.awt.event.InputEvent

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

Methods inherited from class java.awt.event.ComponentEvent

getComponent

Methods inherited from class java.awt.AWTEvent

getID, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

Field Detail

WHEEL_UNIT_SCROLL

@Native
public static final int WHEEL_UNIT_SCROLL

常量表示“单位”滚动（如用箭头键滚动）

另请参见：

getScrollType()， Constant Field Values

WHEEL_BLOCK_SCROLL

@Native
public static final int WHEEL_BLOCK_SCROLL

常量代表滚动的一个“块”（如滚动页面上，页下键）

另请参见：

getScrollType()， Constant Field Values

Constructor Detail

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和肝片将源的位置在屏幕上加上相对坐标X和Y xabs和肝片如果来源不显示设置为零。

请注意，通过在指定的行为无效id结果。该方法抛出一个IllegalArgumentException如果source是null。

参数

source - Component起源事件

id -识别事件的整数

when -长出时间发生的事件

modifiers的修饰键在事件（Shift、Ctrl、Alt、元）

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)

构建了一个具有指定源组件， MouseWheelEvent对象类型、修饰符、坐标，绝对坐标，涡旋，涡旋的数量，和车轮的转动。

请注意，通过在指定的行为无效id结果。该方法抛出一个IllegalArgumentException如果source是null。

即使相对和绝对坐标传递给构造函数的值不一致的情况，mousewheelevent还创建并不会引发异常。

参数

source - Component起源事件

id -识别事件的整数

when -长出时间发生的事件

modifiers的修饰键在事件（Shift、Ctrl、Alt、元）

x -横坐标的鼠标位置

y -鼠标的位置垂直的Y坐标

xAbs的绝对水平的X坐标为鼠标位置

yAbs -绝对垂直的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,
                       double preciseWheelRotation)

构建了一个具有指定源组件， MouseWheelEvent对象类型、修饰符、坐标，绝对坐标，涡旋，涡旋的数量，和车轮的转动。

注意，传递一个无效的id参数结果在未指定的行为。该方法抛出一个IllegalArgumentException如果source等于null。

即使相对和绝对坐标传递给构造函数的值不一致，一个MouseWheelEvent实例仍然是创建并不会引发异常。

参数

source - Component起源事件

id -整数标识事件

when -长值，给出了时间事件发生时

modifiers的修饰键在事件（Shift、Ctrl、Alt、元）

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是空的

从以下版本开始：

一点七

另请参见：

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

返回鼠标滚轮被旋转的“点击次数”，作为一个双。如果鼠标支持一个高分辨率的车轮，部分旋转可能会发生。在这种情况下，返回值将包括一个小数点“单击”。

结果

负的值，如果鼠标滚轮旋转向上或远离用户，和积极的价值观，如果鼠标滚轮被旋转下来或向用户

从以下版本开始：

一点七

另请参见：

getWheelRotation()

getUnitsToScroll

public int getUnitsToScroll()

这是一个方便的方法来帮助在一般情况下，MouseWheelListener -实施量符合平台设置滚动滚动窗格或JScrollPane。（注意，然而，这 ScrollPane和 JScrollPane已经有这个功能了。）

此方法返回的单位数时滚动滚动式mousewheelevent.wheel_unit_scroll，只应如果getScrollType返回mousewheelevent.wheel_unit_scroll叫。

滚动的方向，量的车轮运动，和滚动滚动的平台设置都占。这种方法并不能将可调/滚动单元增量账户价值，这将在滚动的成分不同。

这个方法如何在侦听器中使用的一个简化的例子：

mousewheelmoved（mousewheelevent事件）{SP = getscrollpanefromsomewhere()滚动窗格；可调的属getvadjustable()如果（mousewheelevent。getscrolltype() = = wheel_unit_scroll）{国际totalscrollamount =getunitstoscroll() *事件。getunitincrement() adj.；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

结果

识别事件及其属性的字符串