UIElement3D.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) メソッド

定義

名前空間:

System.Windows

アセンブリ:

PresentationCore.dll

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

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

protected internal 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 Friend Overridable Sub OnPreviewMouseLeftButtonDown (e As MouseButtonEventArgs)

パラメーター

e

MouseButtonEventArgs

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

注釈

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

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

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

OnPreviewMouseLeftButtonDownは、.NET Framework バージョン 3.5 で導入されています。 詳細については、「.NET Framework のバージョンおよび依存関係」を参照してください。