UIElement.MouseLeftButtonDown イベント

  • リファレンス

定義

名前空間:
System.Windows
アセンブリ:
PresentationCore.dll

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

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

実装

MouseLeftButtonDown

注釈

この ルーティング イベント は、要素ツリーを通るバブリング ルートに従っているようですが、実際には、各 UIElementによって要素ツリーに沿って発生および再取得される直接ルーティング イベントです。

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

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

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

重要

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

上記の Important で概説されている問題を解決し、これらのソリューションのいずれかを使用して、クラス処理を持つ派生クラスでマウスの左ボタンダウン イベントのイベントを受け取 MouseLeftButtonDown ることができます。

  • コントロールによって処理済みとしてマークされていないイベントのハンドラー PreviewMouseDown をアタッチします。 これはプレビュー イベントであるため、ルートはルートから開始され、コントロールまでトンネルダウンされます。

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

ルーティングされたイベント情報
識別子フィールド MouseLeftButtonDownEvent
ルーティング戦略 直接
代理人 MouseButtonEventHandler
  • 派生クラスでこのイベントのクラス処理を実装するには、 をオーバーライド OnMouseLeftButtonDown します。

適用対象

こちらもご覧ください