ContentElement.OnMouseLeftButtonDown(MouseButtonEventArgs) メソッド

定義

名前空間:
System.Windows
アセンブリ:
PresentationCore.dll

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

protected public:
 virtual void OnMouseLeftButtonDown(System::Windows::Input::MouseButtonEventArgs ^ e);
protected internal virtual void OnMouseLeftButtonDown(System.Windows.Input.MouseButtonEventArgs e);
abstract member OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnMouseLeftButtonDown : System.Windows.Input.MouseButtonEventArgs -> unit
Protected Friend Overridable Sub OnMouseLeftButtonDown (e As MouseButtonEventArgs)

パラメーター

e
MouseButtonEventArgs

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

注釈

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

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

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

適用対象