ContentElement.MouseDown イベント

  • リファレンス

定義

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

この要素の上にポインターがある状態でマウス ボタンが押されたときに発生します。

public:
 event System::Windows::Input::MouseButtonEventHandler ^ MouseDown;
public event System.Windows.Input.MouseButtonEventHandler MouseDown;
member this.MouseDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event MouseDown As MouseButtonEventHandler

イベントの種類

MouseButtonEventHandler

注釈

このイベントは、このクラスの添付イベントの Mouse.MouseDown エイリアスを作成します。これにより MouseDown 、 が基本要素として継承されるときに ContentElement 、クラス メンバー リストの一部になります。 イベントに MouseDown アタッチされたイベント ハンドラーは、基になる Mouse.MouseDown アタッチされたイベントにアタッチされ、同じイベント データ インスタンスを受け取ります。

イベントはMouseDown、多くの場合、 または MouseRightButtonDownとMouseLeftButtonDown共に発生します。これは、2 つの標準的なマウス ボタンのいずれか 1 つを押した場合に対応します。 MouseLeftButtonDown と MouseRightButtonDown はルーティング イベントでもありますが、これらは直接ルーティング イベントであり、イベントがイベント ルートに沿ってこの要素に Mouse.MouseDown 到達すると、適切なボタン固有のイベントが発生します。 または MouseRightButtonDownについては、「解説」をMouseLeftButtonDown参照してください。

重要

コントロールに似た動作を持つ派生 ContentElement クラス (例: ) には、 Hyperlinkマウス ボタン イベントに固有のクラス処理が含まれる場合があります。 マウスの左ボタンダウン イベントは、コントロールでクラス処理を行う可能性が最も高いイベントです。 クラス処理では、多くの場合、基になる Mouse クラス イベントが処理対象としてマークされます。 イベントが処理済みとしてマークされると、その要素にアタッチされている他のインスタンス ハンドラーは、通常は発生しません。 UI ツリーのルートに向かってバブル方向の要素にアタッチされている他のクラスまたはインスタンス ハンドラーも、通常は発生しません。

上記の 「重要」に記載されている問題を解決し、次のいずれかのソリューションを使用して、クラス処理を持つ派生クラスでマウスの左ボタンダウン イベントのイベントを受け取 MouseDown ることができます。

  • コントロールによって処理済みとしてマークされていない イベントのハンドラー PreviewMouseDown をアタッチします。 これはプレビュー イベントであるため、ルートはルートから開始され、コントロールにトンネルダウンされます。

  • ルーティング イベント データで既に処理済みとしてマークされている場合でも、ハンドラーがイベントをリッスンできるようにするシグネチャ オプションを呼び出 AddHandler して選択することで、プロシージャとしてコントロールにハンドラーを登録します。

ルーティングされたイベント情報
識別子フィールド MouseDownEvent
ルーティング戦略 バブル
代理人 MouseButtonEventHandler

  • 対応するトンネリング イベントは です PreviewMouseDown。

  • 派生クラスでこのイベントのクラス処理を実装するには、 をオーバーライド OnMouseDown します。

適用対象