UIElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) メソッド

定義

未処理の PreviewMouseLeftButtonDown ルーティング イベントが、そのルート上で、このクラスから派生した要素に到達すると呼び出されます。Invoked when an unhandled PreviewMouseLeftButtonDown routed event reaches an element in its route that is derived from this class. このイベントに対するクラス処理を追加するには、このメソッドを実装します。Implement this method to add class handling for this event.

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

イベント データを格納している MouseButtonEventArgsThe MouseButtonEventArgs that contains the event data. このイベント データは、マウスの左ボタンが押されたことを報告します。The event data reports that the left mouse button was pressed.

注釈

PreviewMouseLeftButtonDown イベントは、トンネリングルートを移動するように見えますが、実際には間接的に移動します。The PreviewMouseLeftButtonDown event appears to travel a tunneling route but actually travels in an indirect way. Mouse.PreviewMouseDown はトンネルルーティングされる基になるイベントです。イベントルートに沿った各 UIElement は、同一の処理を使用して、直接ルーティングイベント PreviewMouseLeftButtonDownを発生させます。Mouse.PreviewMouseDown is the underlying event that is tunnel routed, and each UIElement along the event route uses identical handling to raise the direct routed event PreviewMouseLeftButtonDown. この要素の目的のために PreviewMouseLeftButtonDown イベントを処理済みとしてマークできますが、処理された状態は、イベントルートに沿った他の要素に perpetuate ません。Although you can mark the PreviewMouseLeftButtonDown event as handled for purposes of this element, the handled state does not perpetuate to other elements along the event route. ただし、一般的なインスタンスハンドラー (handledEventsTooが指定されていない) が呼び出されないようにするために、イベントを処理済みとしてマークすることもできます。However, you might want to mark the event as handled in order to prevent general instance handlers (those that did not specify handledEventsToo) from being invoked.

UIElement での一般的なマウスイベント処理の既定の実装では Mouse.PreviewMouseDown がリッスンされ、適切なローカルイベントに変換されます。The default implementation for general mouse event handling in UIElement listens for Mouse.PreviewMouseDown and converts it to an appropriate local event. このロジックをオーバーライドする場合は、派生クラスを作成する必要があります。If you want to override this logic, you must create a derived class. 派生クラスの静的コンストラクターで、Mouse.PreviewMouseDownの代替クラスハンドラーを登録します。In the static constructor of your derived class, register an alternative class handler for Mouse.PreviewMouseDown. OnPreviewMouseLeftButtonDownをオーバーライドすることによって、UIElement のマウス処理動作を変更することはできません。You cannot change the mouse handling behavior of UIElement by overriding OnPreviewMouseLeftButtonDown.

または、特定のマウス状態のイベント処理を変更するために、このメソッドをオーバーライドすることもできます。Alternatively, you can override this method in order to change event handling for a specific mouse state. 基本実装の呼び出しを選択するかどうかは、シナリオによって異なります。Whether you choose to call the base implementation depends on your scenario. Base を呼び出さないと、先祖クラスでそのマウスイベントの既定の入力処理が無効になり、OnPreviewMouseLeftButtonDownも呼び出されます。Failing to call base disables default input handling for that mouse event on ancestor classes that also expect to invoke OnPreviewMouseLeftButtonDown. たとえば、Button から派生させ、基本実装を呼び出さずに派生クラスの OnPreviewMouseLeftButtonDown をオーバーライドできます。ただし、このオーバーライドによって Click イベントは無効になります。For example, you can derive from Button and override OnPreviewMouseLeftButtonDown in your derived class without calling the base implementation; however, this override disables the Click event.

適用対象