UIElement.MouseLeftButtonDown イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素の上にマウス ポインターがある状態でマウスの左ボタンが押されたときに発生します。
public:
virtual event System::Windows::Input::MouseButtonEventHandler ^ MouseLeftButtonDown;public event System.Windows.Input.MouseButtonEventHandler MouseLeftButtonDown;member this.MouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler Public Custom Event MouseLeftButtonDown As MouseButtonEventHandler イベントの種類
実装
注釈
この ルーティング イベント は要素ツリーを通過するバブル ルートに従っているようですが、実際には、要素ツリーに沿って各 UIElement要素ツリーに沿って発生して再取得される直接ルーティング イベントです。
このイベントは、基になる Mouse.MouseDown イベントのマウス ボタンの詳細を報告するいくつかの関連イベントの 1 つです。これは、イベント ルートに沿って各要素によって処理される添付イベントです。
このイベントのイベント データは、基になる Mouse.MouseDown イベントのイベント データを公開します。 そのイベントがイベント ルートに沿って処理済みとしてマークされている場合、マウス ボタン固有のイベントは引き続き発生します。ただし、マウス ボタン固有のイベントのハンドラーを追加するには、イベントのリスナーとして既に処理済みとしてマークされているイベントを処理するオプションを使用して、明示的に呼び出 AddHandlerす必要があります。 処理済みとしてマーク MouseLeftButtonDown すると、基本的に、ルートに沿ったその他のすべてのリスナーと、関連するすべてのイベントに対して処理済みとしてマーク Mouse.MouseDown されます。 これには、クラス ハンドラーによって生成されるイベントが MouseDoubleClick含まれている可能性があります。
概念的には、このイベント (およびその他のマウス ボタン イベント UIElement) をマウス "サービス" (クラスによって Mouse 提供されるサービス定義) と考えてください。 このイベントは、イベント データ内の元のマウス イベントのマウス ボタンの状態 (左右、上下) を確認する必要がない便利さを追加します。 標準以外のボタンの状態のチェックなど、より高度なシナリオでは、クラス上の API ではなく UIElementAPI をMouse使用する必要がある場合があります。
重要
コントロール クラスによっては、マウス ボタン イベントに固有のクラス処理が含まれることがあります。 マウスの左ボタンダウン イベントは、コントロールでクラス処理を行う可能性が最も高いイベントです。 クラスの処理では、多くの場合、基になる Mouse クラス イベントが処理対象としてマークされます。 イベントが処理済みとしてマークされると、その要素にアタッチされている他のインスタンス ハンドラーは、通常は発生しません。 UI ツリーのルートに向かってバブル方向の要素にアタッチされているその他のクラスまたはインスタンス ハンドラーも、通常は発生しません。
上記の重要で説明されている問題を解決し、次のいずれかのソリューションを使用して、クラス処理を持つ派生クラスの左マウス ボタンダウン イベントのイベントを受け取 MouseLeftButtonDown ることができます。
コントロールによって処理済みとしてマークされていないイベントのハンドラー PreviewMouseDown をアタッチします。 これはプレビュー イベントであるため、ルートはルートから開始され、コントロールにトンネルダウンされます。
ルーティング イベント データで既に処理済みとしてマークされている場合でも、ハンドラーがイベントをリッスンできるようにする署名オプションを呼び出 AddHandler して選択することで、プロシージャ形式でコントロールにハンドラーを登録します。
ルーティングされたイベント情報
| 識別子フィールド | MouseLeftButtonDownEvent |
| ルーティング戦略 | 直接 |
| 代理人 | MouseButtonEventHandler |
- 派生クラスでこのイベントのクラス処理を実装するオーバーライド OnMouseLeftButtonDown 。