UIElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) メソッド

定義

名前空間:

System.Windows

アセンブリ:

PresentationCore.dll

未処理の PreviewMouseLeftButtonDown ルーティング イベントが、そのルート上で、このクラスから派生した要素に到達すると呼び出されます。 このイベントに対するクラス処理を追加するには、このメソッドを実装します。

protected:
 virtual void OnPreviewMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);

protected virtual void OnPreviewMouseLeftButtonDown (System.Windows.Input.MouseButtonEventArgs e);

abstract member OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnPreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit

Protected Overridable Sub OnPreviewMouseLeftButtonDown (e As MouseButtonEventArgs)

パラメーター

e

MouseButtonEventArgs

イベント データを格納している MouseButtonEventArgs。 このイベント データは、マウスの左ボタンが押されたことを報告します。

注釈

イベントは PreviewMouseLeftButtonDown トンネリング ルートを移動しているように見えますが、実際には間接的な方法で移動します。 Mouse.PreviewMouseDown はトンネル ルーティングされる基になるイベントであり、イベント ルートに沿ってそれぞれ UIElement 同じ処理を使用してダイレクト ルーティング イベント PreviewMouseLeftButtonDownを発生させます。 この要素の目的でイベントを PreviewMouseLeftButtonDown 処理済みとしてマークすることはできますが、処理済みの状態はイベント ルートに沿って他の要素に永続しません。 ただし、イベントを処理済みとしてマークして、一般的なインスタンス ハンドラー (指定 handledEventsTooしなかったハンドラー) が呼び出されないようにすることができます。

の一般的なマウス イベント処理の既定の実装では UIElement 、 が Mouse.PreviewMouseDown リッスンされ、適切なローカル イベントに変換されます。 このロジックをオーバーライドする場合は、派生クラスを作成する必要があります。 派生クラスの静的コンストラクターで、 の代替クラス ハンドラーを Mouse.PreviewMouseDown登録します。 をオーバーライドして のマウス処理の動作 UIElement を OnPreviewMouseLeftButtonDown変更することはできません。

または、特定のマウス状態のイベント処理を変更するために、このメソッドをオーバーライドすることもできます。 基本実装を呼び出すかどうかを選択するかどうかは、シナリオによって異なります。 base の呼び出しに失敗すると、 を呼び出 OnPreviewMouseLeftButtonDownす先祖クラスで、そのマウス イベントの既定の入力処理が無効になります。 たとえば、基本実装を呼び出さずに派生クラスから派生 Button およびオーバーライド OnPreviewMouseLeftButtonDown できます。ただし、このオーバーライドではイベントが Click 無効になります。