UIElement.MouseLeftButtonDown イベント

定義

この要素の上にマウス ポインターがある状態でマウスの左ボタンが押されたときに発生します。

public:
 virtual event System::Windows::Input::MouseButtonEventHandler ^ MouseLeftButtonDown;
public event System.Windows.Input.MouseButtonEventHandler MouseLeftButtonDown;
member this.MouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event MouseLeftButtonDown As MouseButtonEventHandler 

イベントの種類

MouseButtonEventHandler

実装

注釈

この ルーティングイベント は、要素ツリーを通じてバブルルートに従っているように見えますが、実際には、各によって要素ツリーに沿って発生する直接ルーティングイベントです UIElement

このイベントは、 Mouse.MouseDown イベントルートに沿って各要素によって処理される添付イベントである、基になるイベントのマウスボタンの詳細を報告する、関連するいくつかのイベントの1つです。

このイベントのイベントデータは、基になるイベントのイベントデータを公開し Mouse.MouseDown ます。 イベントルートに従ってイベントが処理済みとしてマークされている場合は、マウスボタンの特定のイベントが引き続き発生します。ただし、マウスボタンの特定のイベントのハンドラーは AddHandler 、イベントのリスナーとして既に処理済みとしてマークされているイベントを処理するオプションを指定して、明示的にを呼び出すことによって追加する必要があります。 処理済みとしてマークした場合、 MouseLeftButtonDown 基本的には、ルートに沿った Mouse.MouseDown すべてのリスナーと、関連するすべてのイベントに対して、処理がマークされます。 これには、などのクラスハンドラーで生成されたイベントが含まれることが MouseDoubleClick あります。

概念的には、このイベント (およびその他のマウスボタンイベント UIElement ) は、(クラスによって提供されるサービス定義を使用した) マウス "サービス" と考えることができ Mouse ます。 イベントは、イベントデータ内の元のマウスイベントのマウスボタンの状態 (左右、上から下) をチェックしなくて済むようにします。 標準以外のボタンの状態を確認するなど、より高度なシナリオでは、の Api をではなくクラスで使用する必要がある場合があり Mouse UIElement ます。

重要

一部のコントロールクラスには、マウスボタンイベントに固有のクラス処理が含まれる場合があります。 マウスの左ボタンダウンイベントは、コントロールでクラス処理を行う最も可能性の高いイベントです。 クラスの処理では、多くの場合、基になる Mouse クラスのイベントを処理済みとしてマークします。 イベントが処理済みとしてマークされると、その要素にアタッチされている他のインスタンスハンドラーは通常は発生しません。 UI ツリー内のルートに向かうバブル方向の要素に関連付けられているその他のクラスまたはインスタンスハンドラーも、通常は発生しません。

前の「」で説明されている問題を解決しても、 MouseLeftButtonDown 次のいずれかの方法を使用してクラス処理を持つ派生クラスで、マウスの左ボタンダウンイベントのイベントを受け取ることができます。

  • イベントのハンドラーをアタッチし PreviewMouseDown ます。これは、コントロールによって処理されるようにマークされていません。 これはプレビューイベントであるため、ルートからルートが開始され、コントロールにトンネリングされることに注意してください。

  • を呼び出し、 AddHandler ハンドラーがルーティングイベントデータで既に処理済みとしてマークされている場合でもイベントをリッスンできるようにする署名オプションを選択して、コントロール procedurally にハンドラーを登録します。

ルーティングされたイベント情報

識別子フィールド MouseLeftButtonDownEvent
ルーティング方法 直接
Delegate MouseButtonEventHandler
  • をオーバーライドし OnMouseLeftButtonDown て、派生クラスでこのイベントのクラス処理を実装します。

適用対象

こちらもご覧ください