エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

UIElement.MouseLeftButtonUp イベント

2013/12/12

UIElement から指を離したときに (つまり、UIElement タッチ キャプチャを保持している間) 発生します。

Namespace:  System.Windows
アセンブリ:  System.Windows (System.Windows.dll 内)
XAML の XMLNS: xmlns にマップされていません。

public event MouseButtonEventHandler MouseLeftButtonUp
<uiElement MouseLeftButtonUp="eventhandler"/>

MouseButtonEventHandler に基づくハンドラーを使用して、このイベントを処理します。タッチ イベントの処理方法の詳細については、「クイックスタート:Windows Phone のタッチ入力

MouseLeftButtonDown イベントは、オブジェクトがタップされたときに発生します。オブジェクトをタップした指が離れると、MouseLeftButtonUp イベントが発生します。マウス ボタンが離されたときに指が別のオブジェクトの上に移動した場合は、MouseLeftButtonDown イベントを受け取ったオブジェクトが MouseLeftButtonUp イベントを受け取るとは限りません。ただし、MouseLeftButtonDown が発生した UIElementCaptureMouse を呼び出してタッチ キャプチャを開始すれば、そのオブジェクトの観点から、MouseMoveMouseLeftButtonUp などのタッチ イベントを引き続き受け取ることができます。タッチをキャプチャした場合は、MouseLeftButtonUp の処理の一部として、キャプチャを保持するオブジェクトからタッチ キャプチャを解放することをお勧めします。それには、このイベントの senderReleaseMouseCapture を呼び出します。

ルーティング イベントの動作

MouseLeftButtonUp イベントはバブル イベントです。これは、オブジェクト ツリーの親子関係によって関連付けられたオブジェクトのシーケンス用に複数の MouseLeftButtonUp イベント ハンドラーが登録されている場合、その親子関係の各オブジェクトによってイベントが受け取られることを意味します。"バブル" とは、イベントが、入力条件を直接受け取るオブジェクトから始まり、オブジェクト ツリーを順に上っていくようすを表しています。バブル イベントの場合、イベント ハンドラーに使用できる sender は、イベントが処理されるオブジェクトを識別します。そのオブジェクトは、イベントを開始する入力条件を実際に受け取ったオブジェクトであるとは限りません。イベントを開始したオブジェクトを見つけるには、イベントの RoutedEventArgs イベント データの OriginalSource 値を使用します。

MouseLeftButtonUp と OnMouseLeftButtonUp

MouseLeftButtonUp を継承するコントロールは、OnMouseLeftButtonUp メソッドをオーバーライドして、すべてのインスタンスのハンドラーとしてイベントを処理できます。このイベントの Handled 値を true に設定して、そのコントロール (および、場合によってはコントロールの任意のサブクラス) の任意のインスタンスで MouseLeftButtonUp イベントを抑制することもできます。この実装では、Handled も設定されます。これにより、タッチ操作が MouseLeftButtonUp イベントとして報告されず、このイベントがボタン インスタンスによって処理されなくなります。この操作が行われるのは、このコントロールの用途に対しては Click イベントの方が意味があるためです。詳細については、OnMouseLeftButtonUp を参照してください。

また、既に処理済みのルーティング イベントに対しても呼び出されるように、ハンドラーを登録することもできます。詳細については、「AddHandler」を参照してください。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2015 Microsoft