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

UIElement.CaptureMouse メソッド

2013/12/12

UIElement にタッチ キャプチャを設定します。

Namespace:  System.Windows
アセンブリ:  System.Windows (System.Windows.dll 内)

'宣言
Public Function CaptureMouse As Boolean

戻り値

型: System.Boolean
オブジェクトがタッチ キャプチャを保持している場合は true、それ以外の場合は false を返します。

オブジェクトがタッチ入力をキャプチャしているときは、ユーザーの指がそのオブジェクトの境界領域内にあるかどうかにかかわらず、そのオブジェクトがタッチ入力を受け取ります。通常、タッチ入力はシミュレートされたドラッグ操作中にのみキャプチャされます。タッチ キャプチャを解放するには、キャプチャを保持しているオブジェクトで ReleaseMouseCapture メソッドを呼び出します。

以下のすべての条件が満たされた場合に、タッチ入力をキャプチャできます。

  • 他のオブジェクトがタッチ入力をキャプチャしていない。

  • ユーザーの指が物理的にスクリーンに触れている。

これらの条件のいずれかが満たされない場合、CaptureMouse の戻り値は false です。

最初の CaptureMouse 呼び出しで true が返され、タッチ入力が正常にキャプチャされた場合、同じオブジェクトに対する後続の CaptureMouse 呼び出しでは、条件が変わらない限り、引き続き true が返されます。そのオブジェクトが既にキャプチャを持っていた場合も、CaptureMouse は同じ値を返します。アプリケーションの要件によっては、オブジェクトがキャプチャを保持しているかどうかを追跡する変数、または現在キャプチャを持っているオブジェクトへの参照を提供する変数を設定すると役に立つことがあります。この方法を使用する場合は、各 CaptureMouse 呼び出しに変数を設定し、各 ReleaseMouseCapture 呼び出しの変数をクリアしてください。

UIElement 派生オブジェクトのみがタッチ入力をキャプチャできます。視覚的な特徴を備えていてもタッチ入力をキャプチャできない他のオブジェクトの代表的な例には、Run (親 TextBlock のみがキャプチャできます) およびジオメトリ (親 Path のみがキャプチャできます) があります。

CaptureMouse を呼び出す UIElement は、UI に表示されるヒット テストである必要があります。これは、IsHitTestVisiblefalse を指定できないことを意味します。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2014 Microsoft