|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
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
public class MouseWheelEvent
コンポーネント内でマウスホイールが回転したことを示すイベントです。
ホイールマウスは、中央のボタンの代わりにホイールを使用するマウスです。ホイールはユーザの方向またはその反対方向に回転させることができます。マウスホイールは (ほかの使用方法もありますが) おもにスクロールするために使用されます。
MouseWheelEvent オブジェクトは、コンポーネントの addMouseWheelListener
メソッドを使って「関連する」マウスイベントを受け取るように登録されているすべての MouseWheelListener
オブジェクトに渡されます。各リスナーオブジェクトは、マウスイベントを含む MouseEvent
を取得します。
マウスホイールが特にスクロール Component と関連するため、MouseWheelEvents はほかの MouseEvents とは多少異なった形で送信されます。これは、通常 MouseEvents がマウスカーソルのすぐ下にある Component の変更に影響を与える (たとえば、ボタンをクリックした場合) のに対して、MouseWheelEvents はマウスカーソルの影響を受けない機能があることによります (ScrollPane 内の Component 上にあるホイールの移動は ScrollPane のスクロールバーの 1 つをスクロールします)。
MouseWheelEvents はマウスカーソルの下にある Component からイベントの送信を開始します。この Component で MouseWheelEvents が有効でない場合、イベントは有効な MouseWheelEvents を持つ最初の上位 Container に送信されます。通常、これはホイールスクロールが有効な ScrollPane です。発生元 Component および x、y 軸は、イベントの最終送信先 (ScrollPane) に関連します。これにより、ScrollPane を変更せずに複雑な GUI をインストールし、すべての MouseWheelEvents を ScrollPane に送信してスクロールできるようになります。
一部の AWT Component は、独自のスクロールバーを持ち、独自のスクロール操作を行うネイティブウィジェットを使って実装されます。これが true である特定の Component は、プラットフォームごとに異なります。マウスホイールがこのような Component のいずれかの上を移動すると、イベントは直接ネイティブウィジェットに送信され、上位 Component には送信されません。
プラットフォームは、マウスホイールの移動時に発生するスクロールの量をカスタマイズする機能を提供します。もっとも一般的な 2 つの設定は、特定の「ユニット」の数 (通常は、テキストベースのコンポーネントにおけるテキスト行)、または「ブロック」全体 (ページアップやページダウンに類似する) のスクロールです。MouseWheelEvent は、背後にあるプラットフォームの設定に準拠するためのメソッドを提供します。ユーザは、これらのプラットフォームの設定をいつでも変更できます。MouseWheelEvents は最新の設定を反映します。
MouseWheelListener
,
ScrollPane
,
ScrollPane.setWheelScrollingEnabled(boolean)
,
JScrollPane
,
JScrollPane.setWheelScrollingEnabled(boolean)
,
直列化された形式フィールドの概要 | |
---|---|
static int |
WHEEL_BLOCK_SCROLL
「ブロック」によるスクロール (Page Up キー、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.util.EventObject から継承されたフィールド |
---|
source |
コンストラクタの概要 | |
---|---|
MouseWheelEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int clickCount,
boolean popupTrigger,
int scrollType,
int scrollAmount,
int wheelRotation)
指定された発生元のコンポーネント、型、修飾子、座標、スクロールのタイプ、スクロールの量、およびホイール回転で、 MouseWheelEvent オブジェクトを構築します。 |
メソッドの概要 | |
---|---|
int |
getScrollAmount()
このイベントに応答してスクロールされるユニット数を返します。 |
int |
getScrollType()
このイベントに応答して発生するスクロールのタイプを返します。 |
int |
getUnitsToScroll()
プラットフォームの設定に適合する範囲で、ScrollPane または JScrollPane をスクロールする際に使用する一般的な MouseWheelListener の実装に役立つ便利なメソッドです。 |
int |
getWheelRotation()
マウスホイールを回転させた「クリック」数を返します。 |
String |
paramString()
このイベントを特定するパラメータの文字列を返します。 |
クラス java.awt.event.MouseEvent から継承されたメソッド |
---|
getButton, getClickCount, getMouseModifiersText, getPoint, getX, getY, isPopupTrigger, translatePoint |
クラス java.awt.event.InputEvent から継承されたメソッド |
---|
consume, getModifiers, getModifiersEx, 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.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
---|
public static final int WHEEL_UNIT_SCROLL
getScrollType()
,
定数フィールド値public static final int WHEEL_BLOCK_SCROLL
getScrollType()
,
定数フィールド値コンストラクタの詳細 |
---|
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
オブジェクトを構築します。
無効な id
を渡すと、特定できない動作が発生します。このメソッドは source
が null
の場合に IllegalArgumentException
をスローします。
source
- イベントの発生元の Component
id
- イベントを特定する整数when
- イベントの発生時刻を指定する long 値modifiers
- イベント発生時に押された修飾キー (Shift、Ctrl、Alt、メタ)x
- マウス位置の X 座標 (水平方向)y
- マウス位置の Y 座標 (垂直方向)clickCount
- イベントに関連したマウスクリックの回数popupTrigger
- boolean 型。ポップアップメニューに対するイベントの場合は truescrollType
- このイベントに応答して発生するスクロールのタイプ。有効な値は WHEEL_UNIT_SCROLL
および WHEEL_BLOCK_SCROLL
scrollAmount
- scrollType が WHEEL_UNIT_SCROLL
の場合、スクロールされるユニット数wheelRotation
- マウスホイールが回転した総数 (「クリック」数)
IllegalArgumentException
- source
が null の場合MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean)
メソッドの詳細 |
---|
public int getScrollType()
Adjustable.getUnitIncrement()
,
Adjustable.getBlockIncrement()
,
Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int)
,
Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)
public int getScrollAmount()
getScrollType
が MouseWheelEvent.WHEEL_UNIT_SCROLL
を返す場合にのみ有効です。
getScrollType
が MouseWheelEvent.WHEEL_BLOCK_SCROLL
を返す場合)getScrollType()
public int getWheelRotation()
public int getUnitsToScroll()
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(java.awt.Rectangle, int, int)
,
ScrollPane
,
ScrollPane.setWheelScrollingEnabled(boolean)
,
JScrollPane
,
JScrollPane.setWheelScrollingEnabled(boolean)
public String paramString()
MouseEvent
内の paramString
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。