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. UIElement オーバーライドすることにより、のマウス処理動作を変更することはできません OnPreviewMouseLeftButtonDownYou 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 基本実装を呼び出さずにオーバーライドできます。ただし、このオーバーライドによってイベントは無効になります。 ClickFor 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.

適用対象