Interface MouseEvent

継承元:

UIEvent

プロパティ:

altKey, button, clientX, clientY, ctrlKey, metaKey, relatedTarget, screenX, screenY, shiftKey

メソッド:

initMouseEvent

プロパティ:

• mouseeventObject.altKey

  boolean型, 読取専用

  イベントの発生中に Alt キー が押されているかどうかをあらわす。このキーが代わりのキー名にマップされているプラットフォームもある。

• mouseeventObject.button

  unsigned short型, 読取専用

  マウスボタンの押し下げまたは開放によって発生したマウスイベント中で、button はどのマウスボタンの状態が変更されたかをあらわす。button の値 0 はマウスの左ボタン、1 はもしあれば中ボタン、2 は右ボタンをあらわす。ボタンの挙動が反転する左利き用に構成されたマウスでは、その代わりに値は右から左へ (0, 1, 2 と) 読まれる。

• mouseeventObject.clientX

  long型, 読取専用

  イベントの発生した、DOM 実装のクライアントエリアに関する水平座標。

• mouseeventObject.clientY

  long型, 読取専用

  イベントが発生した、DOM 実装のクライアントエリアに関する垂直座標。

• mouseeventObject.ctrlKey

  boolean型, 読取専用

  イベントの発生中に Ctrl キー が押されているかどうかをあらわす。

• mouseeventObject.metaKey

  boolean型, 読取専用

  イベントの発生中に Meta キー が押されているかどうかをあらわす。このキーが代わりのキー名にマップされているプラットフォームもある。

• mouseeventObject.relatedTarget

  EventTarget型, 読取専用

  UI イベントに関連する補助的な EventTarget を識別する。現在このプロパティは mouseover イベントでポインティングデバイスが退出した EventTarget、および mouseout イベントでポインティングデバイスが入った EventTarget をあらわすのに用いられている。

• mouseeventObject.screenX

  long型, 読取専用

  イベントが発生した、スクリーン座標系の起源に関する水平座標。

• mouseeventObject.screenY

  long型, 読取専用

  イベントが発生した、スクリーン座標系の起源に関する垂直座標。

• mouseeventObject.shiftKey

  boolean型, 読取専用

  イベントの発生中に Shift キー が押されているかどうかをあらわす。

メソッド:

• mouseeventObject.initMouseEvent( typeArg, canBubbleArg, cancelableArg, viewArg, detailArg, screenXArg, screenYArg, clientXArg, clientYArg, ctrlKeyArg, altKeyArg, shiftKeyArg, metaKeyArg, buttonArg, relatedTargetArg )

  initMouseEvent メソッドは DocumentEvent を通して作成される MouseEvent の値を初期化する。このメソッドは、必要ならばフェイズ中に複数回呼び出してよいが、 MouseEvent が DispachEvent メソッド経由で送信される前にのみ呼ぶことができる。複数回呼び出す場合は、最後に実施されるものが先行する。

  引数:

  typeArg / DOMString

  イベントの型。

  canBubbleArg / boolean

  イベントかバブル可能かどうか。

  cancelableArg / boolean

  イベントのデフォルトアクションを回避できるかどうか。

  viewArg / views::AbstractView

  Event の AbstractView。

  detailArg / long

  Event のマウスクリックカウント。

  screenXArg / long

  Event のスクリーンの X 座標。

  screenYArg / long

  Event のスクリーンの Y 座標。

  clientXArg / long

  Event のクライアントの X 座標。

  clientYArg / long

  Event のクライアントの Y 座標。

  ctrlKeyArg / boolean

  Event 中にコントロールキーが押されていたかどうか。

  altKeyArg / boolean

  Event 中に alt キーが押されていたかどうか。

  shiftKeyArg / boolean

  Event 中にシフトキーが押されていたかどうか

  metaKeyArg / boolean

  Event 中にメタキーが押されていたかどうか。

  buttonArg / unsigned short

  Event のマウスボタン

  relatedTargetArg / EventTarget

  Event の関連する EventTarget。

  戻り値:

  (無し)

イベント型:

• click

  click イベントは、ポインティングデバイスのボタンがエレメント上でクリックされたときに発生する。クリックは同じスクリーン位置での mousedown と mouseup として定義される。これらのイベントの発生順は:

      mousedown
      mouseup
      click
  

  同じスクリーン位置で複数のクリックが発生した場合、各繰り返しをインクリメントする プロパティを伴ってシーケンスが繰り返される。このイベントはほとんどのエレメントで有効である。

  Bubbles	true
  Cancelable	true
  Context Info	screenX, screenY, clientX, clientY, altKey, ctrlKey, shiftKey, metaKey, button, detail

• mousedown

  mousedown イベントは、ポインティングデバイスのボタンがエレメント上で押されたときに発生する。このイベントはほとんどのエレメントで有効である。

  Bubbles	true
  Cancelable	true
  Context Info	screenX, screenY, clientX, clientY, altKey, ctrlKey, shiftKey, metaKey, button, detail

• mouseup

  mouseup イベントは、ポインティングデバイスのボタンがエレメント上で離されたときに発生する。このイベントはほとんどのエレメントで有効である。

  Bubbles	true
  Cancelable	true
  Context Info	screenX, screenY, clientX, clientY, altKey, ctrlKey, shiftKey, metaKey, button, detail

• mouseover

  mouseover イベントは、ポインティングデバイスがエレメント上に動かされたときに発生する。このイベントはほとんどのエレメントで有効である。

  Bubbles	true
  Cancelable	true
  Context Info	screenX, screenY, clientX, clientY, altKey, ctrlKey, shiftKey, metaKey, relatedTarget indicates the EventTarget the pointing device is exiting.

• mousemove

  mousemove イベントは、ポインティングデバイスがエレメント上にある間に動かされたときに発生する。このイベントはほとんどのエレメントで有効である。

  Bubbles	true
  Cancelable	false
  Context Info	screenX, screenY, clientX, clientY, altKey, ctrlKey, shiftKey, metaKey

• mouseout

  mouseout イベントは、ポインティングデバイスがエレメントから離れたときに発生する。このイベントはほとんどのエレメントで有効である。

  Bubbles	true
  Cancelable	true
  Context Info	screenX, screenY, clientX, clientY, altKey, ctrlKey, shiftKey, metaKey, relatedTarget indicates the EventTarget the pointing device is entering.

IDL 定義:

// Introduced in DOM Level 2:
interface MouseEvent : UIEvent {
  readonly attribute long             screenX;
  readonly attribute long             screenY;
  readonly attribute long             clientX;
  readonly attribute long             clientY;
  readonly attribute boolean          ctrlKey;
  readonly attribute boolean          shiftKey;
  readonly attribute boolean          altKey;
  readonly attribute boolean          metaKey;
  readonly attribute unsigned short   button;
  readonly attribute EventTarget      relatedTarget;
  void               initMouseEvent(in DOMString typeArg, 
                                    in boolean canBubbleArg, 
                                    in boolean cancelableArg, 
                                    in views::AbstractView viewArg, 
                                    in long detailArg, 
                                    in long screenXArg, 
                                    in long screenYArg, 
                                    in long clientXArg, 
                                    in long clientYArg, 
                                    in boolean ctrlKeyArg, 
                                    in boolean altKeyArg, 
                                    in boolean shiftKeyArg, 
                                    in boolean metaKeyArg, 
                                    in unsigned short buttonArg, 
                                    in EventTarget relatedTargetArg);
};

• Back to Document Object Model Events
• Object Index
• Glossary
• References