クラス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

すべての実装されたインタフェース:

Serializable

public class MouseWheelEvent extends MouseEvent

コンポーネント内でマウス・ホイールが回転したことを示すイベントです。

ホイール・マウスは、中央ボタンの代わりにホイールを持つマウスです。 このホイールはユーザーの方向またはその反対方向に回転させることができます。 マウス・ホイールは(ほかの使用方法もありますが)主にスクロールするために使用されます。

MouseWheelEventオブジェクトは、コンポーネントのaddMouseWheelListenerメソッドを使って「関連する」マウス・イベントを受け取るように登録されているすべてのMouseWheelListenerオブジェクトに渡されます。 各リスナー・オブジェクトは、マウス・イベントを含むMouseEventを取得します。

マウス・ホイールがスクロールするComponentと関係が深いため、MouseWheelEventsはほかのMouseEventsとは多少異なった形で送信されます。 これは、ほかのMouseEventsが通常はマウス・カーソルのすぐ下にあるComponentの変更に影響を与える(たとえば、ボタンをクリックした場合)のに対して、MouseWheelEventsは多くの場合マウス・カーソルに影響しないためです(ScrollPaneのComponent上でホイールを動かすとScrollPaneのScrollbarの1つがスクロールするはずです)。

MouseWheelEventsはマウス・カーソルの下にあるComponentからイベントの送信を開始します。 そのComponentでMouseWheelEventsが有効でない場合、イベントはMouseWheelEventsが有効になっている最初の祖先Containerに送信されます。 これは通常、ホイール・スクロールが有効になっているScrollPaneです。 ソースComponentおよびx、y座標は、イベントの最終送信先(ScrollPane)を基準にします。 これにより、ScrollPaneを変更せずに複雑なGUIをインストールし、すべてのMouseWheelEventsをScrollPaneに送信してスクロールできます。

一部のAWT Componentは、独自のスクロール・バーを表示して独自のスクロールを操作するネイティブ・ウィジェットを使って実装されます。 これがtrueであるComponentは、プラットフォームごとに異なります。 マウス・ホイールがこのようなComponentのいずれかの上を動くと、イベントは直接ネイティブ・ウィジェットに送信され、祖先には伝達されません。

プラットフォームは、マウス・ホイールが動いたときに発生するスクロール量のカスタマイズを提供します。 もっとも一般的な2つの設定は、一定数の「ユニット」(一般的には、テキストベース・コンポーネント内のテキスト行)、または「ブロック」全体(Page UpやPage Downに似ています)のスクロールです。 MouseWheelEventは、基本となるプラットフォーム設定に準拠するためのメソッドを提供します。 ユーザーは、これらのプラットフォーム設定をいつでも変更できます。 MouseWheelEventsは最新の設定を反映します。

MouseWheelEventクラスには、何回の「クリック」でマウス・ホイールが回転したかを取得するメソッドが含まれます。 getWheelRotation()メソッドは、マウス・ホイールが回転したノッチ数に対応する「クリック」数(integer)を返します。 このメソッドに加えて、MouseWheelEventクラスは、部分回転が発生した場合の「クリック」数(double)を返すgetPreciseWheelRotation()メソッドを提供します。 getPreciseWheelRotation()メソッドは、ノッチなしで自由に回転するホイールなどの高解像度ホイールをマウスがサポートしている場合に便利です。 アプリケーションには、このメソッドを利用することでマウス・ホイール・イベントを正確に処理できるという利点があり、視覚的に滑らかにできます。

導入されたバージョン:

1.4

関連項目:

• MouseWheelListener
• ScrollPane
• ScrollPane.setWheelScrollingEnabled(boolean)
• JScrollPane
• JScrollPane.setWheelScrollingEnabled(boolean)
• 直列化された形式

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
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	マウス・イベントに使用されるIDの範囲内の最初の番号です。
static final int	MOUSE_LAST	マウス・イベントに使用されるIDの範囲内の最後の番号です。
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	Mouse Button1の拡張修飾子定数です。
static final int	BUTTON1_MASK	非推奨。 代わりにBUTTON1_DOWN_MASKとInputEvent.getModifiersEx()を使用することをお勧めします
static final int	BUTTON2_DOWN_MASK	Mouse Button2の拡張修飾子定数です。
static final int	BUTTON2_MASK	非推奨。 代わりにBUTTON2_DOWN_MASKとInputEvent.getModifiersEx()を使用することをお勧めします。
static final int	BUTTON3_DOWN_MASK	Mouse Button3の拡張修飾子定数です。
static final int	BUTTON3_MASK	非推奨。 代わりにBUTTON3_DOWN_MASKとInputEvent.getModifiersEx()を使用することをお勧めします。
static final int	CTRL_DOWN_MASK	Ctrlキーの拡張修飾子定数です。
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	コンポーネント・イベントに使用されるIDの範囲内の最初の番号です。
static final int	COMPONENT_HIDDEN	このイベントは、コンポーネントが不可視になったことを示します。
static final int	COMPONENT_LAST	コンポーネント・イベントに使用されるIDの範囲内の最後の番号です。
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	転送元の処理後にイベントをピアに送り返すかどうかを制御します。trueの場合は送り返されず、falseの場合は送り返されます。
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	イベントの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イベントIDの最大値です。
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	Eventが最初に発生したオブジェクト。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
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()	マウス・ホイールを回転させた「クリック」数をdouble値として返します。
int	getScrollAmount()	マウス・ホイール回転のクリックごとにスクロールされるユニット数を返します。
int	getScrollType()	このイベントに応答して発生するスクロールのタイプを返します。
int	getUnitsToScroll()	プラットフォーム設定に準拠する量でScrollPaneまたはJScrollPaneをスクロールする一般的なMouseWheelListenerの実装に役立つ便利なメソッドです。
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)	イベントの発生時に押されていた「Shift」キーや「Ctrl+Shift」キーなどの修飾キーやマウス・ボタンを記述するStringインスタンスを返します。
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」などの拡張修飾子キーおよびマウス・ボタンを記述するStringを返します。
long	getWhen()	このイベントが発生したタイムスタンプと協定世界時のUTC 1970年1月1日深夜零時との差をミリ秒単位で返します。
boolean	isAltDown()	このイベントでAlt修飾子が押されたかどうかを返します。
boolean	isAltGraphDown()	このイベントでAltGraph修飾子が押されたかどうかを返します。
boolean	isConsumed()	このイベントが消費されたかどうかを返します。
boolean	isControlDown()	このイベントでCtrl修飾子が押されたかどうかを返します。
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()	Eventが最初に発生したオブジェクト。

クラスオブジェクトで宣言されたメソッド

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()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

フィールド詳細

WHEEL_UNIT_SCROLL

@Native public static final int WHEEL_UNIT_SCROLL

「ユニット」単位のスクロール(矢印キーによるスクロールなど)を表す定数です。

関連項目:

• getScrollType()
• 定数フィールド値

WHEEL_BLOCK_SCROLL

@Native public static final int WHEEL_BLOCK_SCROLL

「ブロック」単位のスクロール(Page Upキー、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)

指定されたソース・コンポーネント、タイプ、修飾子、座標、スクロール・タイプ、スクロール量、およびホイール回転で、MouseWheelEventオブジェクトを構築します。

絶対座標xAbsとyAbsは、画面上のソースの位置に相対座標xとyを加算した値に設定されます。ソースが表示されていない場合、xAbsとyAbsは0に設定されます。

無効なidを渡すと、未指定の動作になります。 このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

パラメータ:

source - イベントを発生させたComponent

id - イベントを特定する整数

when - イベントの発生時間を渡すlong値

modifiers - イベント発生時に押された修飾キー(Shift、Ctrl、Alt、Meta)

x - マウス位置のx座標(水平方向)

y - マウス位置のy座標(垂直方向)

clickCount - イベントに関連付けられたマウス・クリックの回数

popupTrigger - boolean型。このイベントがポップアップ・メニューのトリガーの場合はtrue

scrollType - このイベントに応答して発生するスクロールのタイプ。有効な値はWHEEL_UNIT_SCROLLおよびWHEEL_BLOCK_SCROLL

scrollAmount - scrollTypeがWHEEL_UNIT_SCROLLの場合、スクロールされるユニット数

wheelRotation - マウス・ホイールを回転させた「クリック」数(整数)

スロー:

IllegalArgumentException - sourceがnullである場合

関連項目:

• MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
• 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を渡すと、未指定の動作になります。 このメソッドはsourceがnullの場合にIllegalArgumentExceptionをスローします。

コンストラクタに渡された相対座標と絶対座標の値が矛盾している場合でもMouseWheelEventインスタンスは作成され、例外はスローされません。

パラメータ:

source - イベントを発生させたComponent

id - イベントを特定する整数

when - イベントの発生時間を渡すlong値

modifiers - イベント発生時に押された修飾キー(Shift、Ctrl、Alt、Meta)

x - マウス位置のx座標(水平方向)

y - マウス位置のy座標(垂直方向)

xAbs - マウス位置の絶対x座標(水平方向)

yAbs - マウス位置の絶対y座標(垂直方向)

clickCount - イベントに関連付けられたマウス・クリックの回数

popupTrigger - boolean型。このイベントがポップアップ・メニューのトリガーの場合はtrue

scrollType - このイベントに応答して発生するスクロールのタイプ。有効な値はWHEEL_UNIT_SCROLLおよびWHEEL_BLOCK_SCROLL

scrollAmount - scrollTypeがWHEEL_UNIT_SCROLLの場合、スクロールされるユニット数

wheelRotation - マウス・ホイールを回転させた「クリック」数(整数)

スロー:

IllegalArgumentException - sourceがnullである場合

導入されたバージョン:

1.6

関連項目:

• MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
• 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パラメータを渡すと、未指定の動作になります。 このメソッドはsourceがnullに等しい場合にIllegalArgumentExceptionをスローします。

コンストラクタに渡された相対座標と絶対座標の値が矛盾している場合でもMouseWheelEventインスタンスは作成され、例外はスローされません。

パラメータ:

source - イベントを発生させたComponent

id - イベントを特定する整数値

when - イベントの発生時間を渡すlong値

modifiers - イベント発生時に押された修飾キー(Shift、Ctrl、Alt、Meta)

x - マウス位置のx座標(水平方向)

y - マウス位置のy座標(垂直方向)

xAbs - マウス位置の絶対x座標(水平方向)

yAbs - マウス位置の絶対y座標(垂直方向)

clickCount - イベントに関連付けられたマウス・クリックの回数

popupTrigger - boolean値。このイベントがポップアップ・メニューのトリガーの場合はtrue

scrollType - このイベントに応答して発生するスクロールのタイプ。有効な値はWHEEL_UNIT_SCROLLおよびWHEEL_BLOCK_SCROLL

scrollAmount - scrollTypeがWHEEL_UNIT_SCROLLの場合、スクロールされるユニット数

wheelRotation - マウス・ホイールを回転させた「クリック」数(整数)

preciseWheelRotation - マウス・ホイールを回転させた「クリック」数(double)

スロー:

IllegalArgumentException - sourceがnullである場合

導入されたバージョン:

1.7

関連項目:

• MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
• 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(Rectangle, int, int)
• Scrollable.getScrollableBlockIncrement(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()

マウス・ホイールを回転させた「クリック」数をdouble値として返します。 マウスが高解像度ホイールをサポートしている場合、部分回転が発生することがあります。 この場合、戻り値には部分的な「クリック」が含まれます。

戻り値:

マウス・ホイールが上側またはユーザーから離れる方向に回転した場合は負の値、マウス・ホイールが下側またはユーザーに向かって回転した場合は正の値

導入されたバージョン:

1.7

関連項目:

• getWheelRotation()

getUnitsToScroll

public int getUnitsToScroll()

プラットフォーム設定に準拠する量でScrollPaneまたはJScrollPaneをスクロールする一般的なMouseWheelListenerの実装に役立つ便利なメソッドです。 ただし、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);
     }
 }

戻り値:

スクロールされるユニット数(マウス・ホイール回転の方向と量、およびネイティブ・プラット・フォームのホイール・スクロール設定に基づく)

関連項目:

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

paramString

public String paramString()

このイベントを特定するパラメータ文字列を返します。 このメソッドは、イベント・ログの作成およびデバッグに便利です。

オーバーライド:

paramString、クラスMouseEvent

戻り値:

イベントを特定する文字列とその属性