ContentElement.PreviewMouseLeftButtonDown イベント

定義

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

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

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

イベントの種類

MouseButtonEventHandler

実装

PreviewMouseLeftButtonDown

注釈

この ルーティング イベントの概要 は、要素ツリーを介したトンネリング ルートに従っているようですが、実際には、各 ContentElementによって要素ツリーに沿って発生し、再評価される直接ルーティング イベントです。

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

このイベントの引数は、基になる Mouse.PreviewMouseDown イベントの引数を公開します。 そのイベントがイベント ルートに沿って処理済みとしてマークされている場合、マウス ボタン固有のイベントは引き続き発生します。ただし、マウス ボタン固有のイベントのハンドラーを追加するには、 AddHandlerを明示的に呼び出し、既に処理済みとしてマークされているイベントを処理するオプションを使用して、イベントのリスナーにする必要があります。

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

ルーティング イベント情報

品目 価値
識別子フィールド PreviewMouseLeftButtonDownEvent
ルーティング戦略 直接
代理人 MouseButtonEventHandler
  • 派生クラスでこのイベントのクラス処理を実装するには、 OnPreviewMouseLeftButtonDown をオーバーライドします。

適用対象

こちらもご覧ください