|
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
public class MouseEvent
コンポーネント内でマウスアクションが発生したことを示すイベントです。マウスアクションは、アクション発生時にマウスカーソルが明示されたコンポーネントの境界上にあるときにのみ、発生したと見なされます。コンポーネントの境界は、可視的なコンポーネントの子、メニュー、または最上位ウィンドウによって非表示にできます。このイベントは、マウスイベント (クリックおよびコンポーネントへの出入り) およびマウスモーションイベント (移動とドラッグ) の両方で使用されます。
このイベントはコンポーネントオブジェクトによって生成される低レベルイベントであり、次の場合に生成されます。
MouseEvent
オブジェクトは、コンポーネントの addMouseListner
メソッドを使って、「関連する」マウスイベントを受け取るように登録されているすべての MouseListener
オブジェクトまたは MouseAdapter
オブジェクトに渡されます。MouseAdapter
オブジェクトは、MouseListener
インタフェースを実装しています。各リスナーオブジェクトは、マウスイベントを含む MouseEvent
を取得します。
また、MouseEvent
オブジェクトは、コンポーネントの addMouseMotionListener
メソッドを使って、マウスモーションイベントを受け取るように登録されているすべての MouseMotionListener
オブジェクトまたは MouseMotionAdapter
オブジェクトに渡されます。MouseMotionAdapter
オブジェクトは、MouseMotionListener
インタフェースを実装しています。各リスナーオブジェクトは、マウスモーションイベントを含む MouseEvent
を取得します。
マウスボタンをクリックするとイベントが生成され、登録されている MouseListener
に送られます。モーダルキーの状態は、InputEvent.getModifiers()
および InputEvent.getModifiersEx()
を使って検出できます。InputEvent.getModifiers()
によって返されたボタンマスクは、すべてのボタンの現在の状態ではなく、状態が変更されたボタンのみを反映します (注: ALT_MASK/BUTTON2_MASK および META_MASK/BUTTON3_MASK の値がオーバーラップするため、修飾キーが関連するマウスイベントの場合は、これが常にあてはまるわけではありません)。すべてのボタンおよび修飾キーの状態を取得するには、InputEvent.getModifiersEx()
を使用します。状態が変更されたボタンは getButton()
により返されます。
たとえば、マウスの第 1 ボタンを押すと、イベントは次の順序で送信されます。
id modifiers button複数のマウスボタンを押した場合は、各ボタンのプレス、リリース、クリックに対して個別のイベントが生成されます。MOUSE_PRESSED
:BUTTON1_MASK
BUTTON1
MOUSE_RELEASED
:BUTTON1_MASK
BUTTON1
MOUSE_CLICKED
:BUTTON1_MASK
BUTTON1
たとえば、ユーザがボタン 1 に続いてボタン 2 を押し、同じ順序でボタンを離した場合、次の一連のイベントが生成されます。
id modifiers buttonボタン 2 を先に離した場合には、MOUSE_PRESSED
:BUTTON1_MASK
BUTTON1
MOUSE_PRESSED
:BUTTON2_MASK
BUTTON2
MOUSE_RELEASED
:BUTTON1_MASK
BUTTON1
MOUSE_CLICKED
:BUTTON1_MASK
BUTTON1
MOUSE_RELEASED
:BUTTON2_MASK
BUTTON2
MOUSE_CLICKED
:BUTTON2_MASK
BUTTON2
BUTTON2_MASK
の MOUSE_RELEASED
/MOUSE_CLICKED
のペアが 先に生成され、そのあとに BUTTON1_MASK
の MOUSE_RELEASED
/MOUSE_CLICKED
のペアが生成されます。
MOUSE_DRAGGED
イベントは、マウスのボタンを離すまで、マウスのボタンが押された Component
に (マウスの位置がその Component
の境界内にあるかどうかに関係なく) 継続して送られます。ドラッグ&ドロップの実装はプラットフォームによって異なるため、ネイティブのドラッグ&ドロップの操作中に MOUSE_DRAGGED
イベントは転送されません。マルチスクリーン環境の場合には、マウスの位置がこの Component
に関連した GraphicsConfiguration
の境界の外側にある場合でも、マウスドラッグイベントは Component
に送られます。ただし、この場合にマウスドラッグイベントで報告されるマウスの位置は、実際のマウスの位置と異なることがあります。
Component
に関連した GraphicsConfiguration
の境界内に収められるComponent
に関連した仮想デバイスの境界内に収められる
MouseAdapter
,
MouseListener
,
MouseMotionAdapter
,
MouseMotionListener
,
MouseWheelListener
,
Tutorial: Writing a Mouse Listener,
Tutorial: Writing a Mouse Motion Listener,
Reference: The Java Class Libraries (update file),
直列化された形式フィールドの概要 | |
---|---|
static int |
BUTTON1
getButton() によって使用されるマウスボタン 1 がないことを示します。 |
static int |
BUTTON2
getButton() によって使用されるマウスボタン 2 がないことを示します。 |
static int |
BUTTON3
getButton() によって使用されるマウスボタン 3 がないことを示します。 |
static int |
MOUSE_CLICKED
「マウスクリック」イベントです。 |
static int |
MOUSE_DRAGGED
「マウドラッグ」イベントです。 |
static int |
MOUSE_ENTERED
「マウスエンター」イベントです。 |
static int |
MOUSE_EXITED
「マウスイグジット」イベントです。 |
static int |
MOUSE_FIRST
マウスイベント識別子の範囲を示す最初の番号です。 |
static int |
MOUSE_LAST
マウスイベント識別子の範囲を示す最後の番号です。 |
static int |
MOUSE_MOVED
「マウスムーブ」イベントです。 |
static int |
MOUSE_PRESSED
「マウスプレス」イベントです。 |
static int |
MOUSE_RELEASED
「マウスリリース」イベントです。 |
static int |
MOUSE_WHEEL
「マウスホイール」イベントです。 |
static int |
NOBUTTON
getButton() によって使用されるマウスボタンがないことを示します。 |
クラス 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 |
コンストラクタの概要 | |
---|---|
MouseEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int clickCount,
boolean popupTrigger)
指定された発生元のコンポーネント、タイプ、修飾子、座標、クリックカウントで、 MouseEvent オブジェクトを構築します。 |
|
MouseEvent(Component source,
int id,
long when,
int modifiers,
int x,
int y,
int clickCount,
boolean popupTrigger,
int button)
指定された発生元のコンポーネント、タイプ、修飾子、座標、クリックカウントで、 MouseEvent オブジェクトを構築します。 |
メソッドの概要 | |
---|---|
int |
getButton()
状態が変更されたマウスボタンがある場合、そのマウスボタンを返します。 |
int |
getClickCount()
このイベントに関連したマウスクリック数を返します。 |
static String |
getMouseModifiersText(int modifiers)
イベントの発生時に押されていた「Shift キー」や「Ctrl+Shift キー」などの修飾キーやマウスボタンを記述する String を返します。 |
Point |
getPoint()
発生元のコンポーネントを基準とする、イベントの相対 x、y 座標値を返します。 |
int |
getX()
イベントが発生した位置の X 座標を発生元のコンポーネントに対する相対位置で返します。 |
int |
getY()
イベントが発生した位置の Y 座標を発生元のコンポーネントに対する相対位置で返します。 |
boolean |
isPopupTrigger()
このマウスイベントが、そのプラットフォームのポップアップメニュートリガイベントであるかどうかを返します。 |
String |
paramString()
このイベントを特定するパラメータの文字列を返します。 |
void |
translatePoint(int x,
int y)
指定されたオフセットの x (水平方向) および y (垂直方向) を加算することにより、イベントの座標を新しい位置に移動します。 |
クラス 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 MOUSE_FIRST
public static final int MOUSE_LAST
public static final int MOUSE_CLICKED
MouseEvent
は、マウスボタンを押して離すと発生します。
public static final int MOUSE_PRESSED
MouseEvent
は、マウスボタンを押すと発生します。
public static final int MOUSE_RELEASED
MouseEvent
は、マウスボタンを離すと発生します。
public static final int MOUSE_MOVED
MouseEvent
は、マウスの位置を変更すると発生します。
public static final int MOUSE_ENTERED
MouseEvent
は、マウスカーソルがコンポーネントのジオメトリの明示された領域に入ると発生します。
public static final int MOUSE_EXITED
MouseEvent
は、マウスカーソルがコンポーネントのジオメトリの明示された領域から出ると発生します。
public static final int MOUSE_DRAGGED
MouseEvent
は、マウスボタンを押している間にマウスの位置が変更されると発生します。
public static final int MOUSE_WHEEL
MouseWheelEvent
のみです。ホイール付きマウスのホイールを回転させると発生します。
public static final int NOBUTTON
getButton()
によって使用されるマウスボタンがないことを示します。
public static final int BUTTON1
getButton()
によって使用されるマウスボタン 1 がないことを示します。
public static final int BUTTON2
getButton()
によって使用されるマウスボタン 2 がないことを示します。
public static final int BUTTON3
getButton()
によって使用されるマウスボタン 3 がないことを示します。
コンストラクタの詳細 |
---|
public MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int button)
MouseEvent
オブジェクトを構築します。
無効な id
を渡すと、特定できない動作が発生します。無効なイベントを生成すると (複数の old _MASK、または一致しない修飾子/ボタン値などを使用することによって)、特定できない動作が発生します。source
が null
の場合、このメソッドは IllegalArgumentException
をスローします。
source
- イベントの発生元の Component
id
- イベントを特定する整数when
- イベントの発生時刻を指定する long int 値modifiers
- イベント発生時に押された修飾キー (Shift、Ctrl、Alt、メタなど)。拡張された _DOWN_MASK または以前の _MASK 修飾子のいずれかを使用する必要がある。ただし、両方のモデルを 1 つのイベントに混合してはならない。拡張修飾子の使用が望ましいx
- マウス位置の X 座標 (水平方向)y
- マウス位置の Y 座標 (垂直方向)clickCount
- イベントに関連したマウスクリックの回数popupTrigger
- boolean 型。ポップアップメニューに対するイベントの場合は truebutton
- 状態が変更されたマウスボタン。NOBUTTON
、BUTTON1
、BUTTON2
、または BUTTON3
IllegalArgumentException
- 無効な button
値が渡された場合
IllegalArgumentException
- source
が null の場合public MouseEvent(Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger)
MouseEvent
オブジェクトを構築します。
無効な id
を渡すと、特定できない動作が発生します。このメソッドは source
が null
の場合に IllegalArgumentException
をスローします。
source
- イベントの発生元の Component
id
- イベントを特定する整数when
- イベントの発生時刻を指定する long int 値modifiers
- イベント発生時に押された修飾キー (Shift、Ctrl、Alt、メタなど)。拡張された _DOWN_MASK または以前の _MASK 修飾子のいずれかを使用する必要がある。ただし、両方のモデルを 1 つのイベントに混合してはならない。拡張修飾子の使用が望ましいx
- マウス位置の X 座標 (水平方向)y
- マウス位置の Y 座標 (垂直方向)clickCount
- イベントに関連したマウスクリックの回数popupTrigger
- boolean 型。ポップアップメニューに対するイベントの場合は true
IllegalArgumentException
- source
が null の場合メソッドの詳細 |
---|
public int getX()
public int getY()
public Point getPoint()
Point
オブジェクトpublic void translatePoint(int x, int y)
x
(水平方向) および y
(垂直方向) を加算することにより、イベントの座標を新しい位置に移動します。
x
- 現在の X 座標に加算される x (水平方向) の値y
- 現在の Y 座標に加算される y (垂直方向) の値public int getClickCount()
public int getButton()
NOBUTTON
、BUTTON1
、BUTTON2
、またはBUTTON3
のいずれかpublic boolean isPopupTrigger()
注: ポップアップメニューのトリガはシステムによって異なります。したがって、共通プラットフォームを適切に機能させるために、mousePressed
および mouseReleased
の両方で isPopupTrigger
をチェックする必要があります。
public static String getMouseModifiersText(int modifiers)
String
を返します。これらの文字列は awt.properties
ファイルを変更することにより地域対応が可能です。
InputEvent.ALT_MASK
と InputEvent.BUTTON2_MASK
は同じ値になるため、どちらの修飾子に対しても文字列「Alt」が返されます。同様に、InputEvent.META_MASK
と InputEvent.BUTTON3_MASK
は同じ値になるため、どちらの修飾子に対しても文字列「Meta」が返されます。
modifiers
- イベントの発生時に押されていた修飾キーおよびマウスボタンを記述する修飾子マスク
InputEvent.getModifiersExText(int)
public String paramString()
ComponentEvent
内の 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 も参照してください。