Mouse.MouseUp 添付イベント


任意のマウス ボタンが離されると発生します。Occurs when any mouse button is released.

see AddMouseUpHandler, and RemoveMouseUpHandler
see AddMouseUpHandler, and RemoveMouseUpHandler
see AddMouseUpHandler, and RemoveMouseUpHandler


どのマウスボタンが離されたかは、イベントの引数を確認することによって決定されます。Which mouse button was released is determined by checking the arguments of the event.

これは添付イベントです。This is an attached event. WPFWPF は、添付イベントをルーティングイベントとして実装します。implements attached events as routed events. 添付イベントは、基本的には、イベントを定義していないオブジェクトで処理できるイベントを参照するための XAMLXAML 言語の概念です。これは、イベントがルートを走査できるようにすることで WPFWPF 拡張されます。Attached events are fundamentally a XAMLXAML language concept for referencing events that can be handled on objects that do not define that event, which WPFWPF expands upon by also enabling the event to traverse a route. アタッチされたイベントには、コードで直接処理構文がありません。コードでルーティングイベントのハンドラーをアタッチするには、指定された Add * Handler メソッドを使用します。Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. 詳細については、「添付イベントの概要」を参照してください。For details, see Attached Events Overview.

Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) framework は、このアタッチされたイベントに基づいて UIElement: MouseLeftButtonUpMouseRightButtonUpに2つの異なる 共通言語ランタイム (CLR)common language runtime (CLR) イベントとして提示します。The Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) framework builds on this attached event by surfacing it as two different 共通言語ランタイム (CLR)common language runtime (CLR) events on UIElement: MouseLeftButtonUp and MouseRightButtonUp. これらの実装は、基になる MouseUp イベントを処理し、イベントの引数を読み取って、マウスの左ボタンまたは右ボタンが関係していたかどうかを判断します。These implementations handle the underlying MouseUp event and read the arguments of the event to determine whether the left or right mouse button was involved. 3つのボタンについては、中央ボタンのフレームワークレベルのイベントサポートがないため、MouseUp イベントを使用して、イベント引数の中央ボタンの条件を確認する必要があります。For three-button, there is no framework-level event support for the center button, and you should use the MouseUp event and check for the center button condition in the event arguments.

マウスに関連するルーティングイベントの場合は、どのように処理されたかをマークする方法やタイミングに注意してください。For routed events that relate to the mouse, be careful about how or when you mark them handled. 特定のマウスアクションについて親要素にも通知する必要があるかどうかについて、適切な選択を行うことが困難です。これは、WPFWPF framework が、基になる Mouse ルーティングイベントをルートに沿って CLRCLR イベントとして表示するためのモデルを選択したためです。The difficulty in making the appropriate choices about whether parent elements should also be informed about any given mouse action is in fact why the WPFWPF framework chose the model of having the underlying Mouse routed event be surfaced as CLRCLR events all along the route.

ルーティングのマウスイベントにも同様の問題があります。Similar issues exist with tunneling mouse events. イベントを処理し、そのイベントがソースに対してそれ以上の子によって処理されないようにする必要があります。また、複合部分にマウスの動作が期待される可能性があるコントロールの合成にはどのように影響しますか。Should you handle the event and not have it be handled by children further towards the source, and how would that affect compositing in a control where the compositing pieces might have expected mouse behaviors?

ルーティングされたイベント情報Routed Event Information

識別子フィールドIdentifier field MouseUpEvent
ルーティング方法Routing strategy バブリングBubbling
委任Delegate MouseButtonEventHandler

対応するトンネリングイベントは PreviewMouseUpです。The corresponding tunneling event is PreviewMouseUp.