ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) ContentElement.OnPreviewMouseLeftButtonDown(MouseButtonEventArgs) Method

定義

未処理の 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 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 MouseButtonEventArgs 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 基になるイベントに、ルーティング、トンネルとは、ContentElementルートが直接ルーティング イベントを発生させると同じ処理を使用、イベントに沿ったPreviewMouseLeftButtonDownします。Mouse.PreviewMouseDown is the underlying event that is tunnel routed, and each ContentElement along the event route uses identical handling to raise the direct routed event PreviewMouseLeftButtonDown. マークすることができますが、PreviewMouseLeftButtonDownこの要素の目的は、イベントを処理済みの状態はイベント ルート上の他の要素には永続化されません。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.

処理の一般的なマウス イベントの既定の実装ContentElementリッスンMouse.PreviewMouseDown適切なローカル イベントに変換します。The default implementation for general mouse event handling in ContentElement 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. マウスの処理の動作を変更することはできませんContentElementオーバーライドすることでOnPreviewMouseLeftButtonDownします。You cannot change the mouse handling behavior of ContentElement 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. 呼び出すことも期待する先祖クラスにそのマウス イベントの既定の入力処理を無効に呼び出しに失敗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.

適用対象