public interface MouseEvent extends UIEvent
MouseEvent
インタフェースは、マウス・イベントに関連する固有のコンテキスト情報を提供します。
UIEvent
から継承されたdetail
属性は、ユーザー・アクション中に画面の同じ位置でマウス・ボタンを押して離す回数を示します。 このアクションを開始するときの属性値は1で、押して離す一連の動作が完全に行われるたびに値が1増加します。 マウスダウンしてマウス・アップする間にマウスを動かすと値は0に設定され、クリックされていないことが示されます。
入れ子にされた要素の場合、マウス・イベントは常に、いちばん深く入れ子にされた要素をターゲットにします。 ターゲットにされた要素の上位要素は、バブリングを使用してその下位要素内で発生するマウス・イベントの通知を取得します。
「Document Object Model (DOM) Level 2 Events Specification」も参照してください。
- 導入されたバージョン:
- 1.5、DOMレベル2
-
フィールドのサマリー
インタフェース org.w3c.dom.events.Eventで宣言されたフィールド
AT_TARGET, BUBBLING_PHASE, CAPTURING_PHASE
-
メソッドのサマリー
修飾子と型メソッド説明boolean
イベントのトリガー中に「Alt」キーが押されていたかどうかを示す場合に使用します。short
マウス・ボタンを押したり放したりすることでマウス・イベントが発生している間は、button
を使用して、どのマウス・ボタンの状態が変更されたかを示します。int
DOM実装のクライアント領域に対してイベントが発生した位置の水平座標です。int
DOM実装のクライアント領域に対してイベントが発生した位置の垂直座標です。boolean
イベントのトリガー中に「Ctrl」キーが押されていたかどうかを示す場合に使用します。boolean
イベントのトリガー中に「Meta」キーが押されていたかどうかを示す場合に使用します。UIイベントに関連する2次のEventTarget
を識別するときに使用します。int
画面の座標体系の原点に対してイベントが発生した位置の水平座標です。int
画面の座標体系の原点に対してイベントが発生した位置の垂直座標です。boolean
イベントのトリガー中に「Shift」キーが押されていたかどうかを示す場合に使用します。void
initMouseEvent(String typeArg, boolean canBubbleArg, boolean cancelableArg, AbstractView viewArg, int detailArg, int screenXArg, int screenYArg, int clientXArg, int clientYArg, boolean ctrlKeyArg, boolean altKeyArg, boolean shiftKeyArg, boolean metaKeyArg, short buttonArg, EventTarget relatedTargetArg)
initMouseEvent
メソッドは、DocumentEvent
インタフェースによって作成されるMouseEvent
の値を初期化する場合に使用します。インタフェース org.w3c.dom.events.Eventで宣言されたメソッド
getBubbles, getCancelable, getCurrentTarget, getEventPhase, getTarget, getTimeStamp, getType, initEvent, preventDefault, stopPropagation
インタフェース org.w3c.dom.events.UIEventで宣言されたメソッド
getDetail, getView, initUIEvent
-
メソッドの詳細
-
getScreenX
int getScreenX()画面の座標体系の原点に対してイベントが発生した位置の水平座標です。 -
getScreenY
int getScreenY()画面の座標体系の原点に対してイベントが発生した位置の垂直座標です。 -
getClientX
int getClientX()DOM実装のクライアント領域に対してイベントが発生した位置の水平座標です。 -
getClientY
int getClientY()DOM実装のクライアント領域に対してイベントが発生した位置の垂直座標です。 -
getCtrlKey
boolean getCtrlKey()イベントのトリガー中に「Ctrl」キーが押されていたかどうかを示す場合に使用します。 -
getShiftKey
boolean getShiftKey()イベントのトリガー中に「Shift」キーが押されていたかどうかを示す場合に使用します。 -
getAltKey
boolean getAltKey()イベントのトリガー中に「Alt」キーが押されていたかどうかを示す場合に使用します。 プラットフォームによっては、このキーが代替キーの名前に対応付けられている場合があります。 -
getMetaKey
boolean getMetaKey()イベントのトリガー中に「Meta」キーが押されていたかどうかを示す場合に使用します。 プラットフォームによっては、このキーが代替キーの名前に対応付けられている場合があります。 -
getButton
short getButton()マウス・ボタンを押したり放したりすることでマウス・イベントが発生している間は、button
を使用して、どのマウス・ボタンの状態が変更されたかを示します。button
の値の範囲は、マウスの左ボタンを示す0、中央のボタン(存在する場合)を示す1、および右ボタンを示す2です。 左利き用に構成されたマウスの場合、ボタン・アクションは逆で、値は右から左の順になります。 -
getRelatedTarget
EventTarget getRelatedTarget()UIイベントに関連する2次のEventTarget
を識別するときに使用します。 現在、この属性は、ポインティング・デバイスが抜けたEventTarget
を示すためにマウスオーバー・イベントで、またポインティング・デバイスが入ったEventTarget
を示すためにマウスアウト・イベントで使用されます。 -
initMouseEvent
void initMouseEvent(String typeArg, boolean canBubbleArg, boolean cancelableArg, AbstractView viewArg, int detailArg, int screenXArg, int screenYArg, int clientXArg, int clientYArg, boolean ctrlKeyArg, boolean altKeyArg, boolean shiftKeyArg, boolean metaKeyArg, short buttonArg, EventTarget relatedTargetArg)initMouseEvent
メソッドは、DocumentEvent
インタフェースによって作成されるMouseEvent
の値を初期化する場合に使用します。 このメソッドは、MouseEvent
がdispatchEvent
メソッドを介してディスパッチされる前にかぎり呼び出されますが、必要な場合はその段階で複数回呼び出されることもあります。 複数回呼び出された場合は、最後の呼出しが優先されます。- パラメータ:
typeArg
- イベントの型を指定します。canBubbleArg
- イベントをバブルできるかどうかを指定します。cancelableArg
- イベントのデフォルト・アクションを抑制できるかどうかを指定します。viewArg
-Event
のAbstractView
を指定します。detailArg
-Event
のマウスのクリック数を指定します。screenXArg
-Event
の画面のx座標を指定しますscreenYArg
-Event
の画面のy座標を指定しますclientXArg
-Event
のクライアントのx座標を指定しますclientYArg
-Event
のクライアントのy座標を指定しますctrlKeyArg
-Event
中にCtrlキーが押されていたかどうかを指定します。altKeyArg
-Event
中にAltキーが押されていたかどうかを指定します。shiftKeyArg
-Event
中にShiftキーが押されていたかどうかを指定します。metaKeyArg
-Event
中にMetaキーが押されていたかどうかを指定します。buttonArg
-Event
のマウス・ボタンを指定します。relatedTargetArg
-Event
の関連するEventTarget
を指定します。
-