MouseDevice.Capture メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した要素へのマウス入力をキャプチャします。
オーバーロード
| 名前 | 説明 |
|---|---|
| Capture(IInputElement) |
指定した要素へのマウス イベントをキャプチャします。 |
| Capture(IInputElement, CaptureMode) |
指定した CaptureModeを使用して、指定した要素へのマウス入力をキャプチャします。 |
注釈
要素がマウスをキャプチャすると、カーソルが境界線内にあるかどうかにかかわらず、マウス入力を受け取ります。
CaptureModeが指定されていない場合、既定のCaptureModeはElement。
マウス キャプチャを解放するには、キャプチャする要素としてCaptureを渡null呼び出します。
MouseDownまたはMouseUpイベントが発生したときにマウスがキャプチャされ、入力がマウスの下の要素に移動しない場合は、最初にPreviewMouseDownOutsideCapturedElementとPreviewMouseUpOutsideCapturedElementが発生します。 これにより、キャプチャされた要素は、 MouseDown イベントと MouseUp イベントがルーティングされる前にキャプチャを解放できます。
Capture(IInputElement)
指定した要素へのマウス イベントをキャプチャします。
public:
bool Capture(System::Windows::IInputElement ^ element);public bool Capture(System.Windows.IInputElement element);member this.Capture : System.Windows.IInputElement -> boolPublic Function Capture (element As IInputElement) As Booleanパラメーター
- element
- IInputElement
マウスをキャプチャする要素。
返品
true 要素がマウスをキャプチャできた場合。それ以外の場合は false。
例外
element が UIElement または ContentElementではありません。
注釈
要素がマウスをキャプチャすると、カーソルが境界線内にあるかどうかに関するマウス入力を受け取ります。
CaptureModeが指定されていない場合、既定のCaptureModeはElement。
マウス キャプチャを解放するには、キャプチャする要素としてCaptureを渡null呼び出します。
MouseDownまたはMouseUpイベントが発生したときにマウスがキャプチャされ、入力がマウスの下の要素に移動しない場合は、最初にPreviewMouseDownOutsideCapturedElementとPreviewMouseUpOutsideCapturedElementが発生します。 これにより、キャプチャされた要素は、 MouseDown イベントと MouseUp イベントがルーティングされる前にキャプチャを解放できます。
適用対象
Capture(IInputElement, CaptureMode)
指定した CaptureModeを使用して、指定した要素へのマウス入力をキャプチャします。
public:
bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);[System.Security.SecurityCritical]
public bool Capture(System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);public bool Capture(System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);[<System.Security.SecurityCritical>]
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> boolmember this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> boolPublic Function Capture (element As IInputElement, captureMode As CaptureMode) As Booleanパラメーター
- element
- IInputElement
マウスをキャプチャする要素。
- captureMode
- CaptureMode
使用するキャプチャ ポリシー。
返品
true 要素がマウスをキャプチャできた場合。それ以外の場合は false。
- 属性
例外
element が UIElement または ContentElementではありません。
captureMode は有効な CaptureModeではありません。
注釈
要素がマウスをキャプチャすると、カーソルが境界線内にあるかどうかにかかわらず、マウス入力を受け取ります。
マウス キャプチャを解放するには、キャプチャする要素としてCaptureを渡null呼び出します。
MouseDownまたはMouseUpイベントが発生したときにマウスがキャプチャされ、入力がマウスの下の要素に移動しない場合は、最初にPreviewMouseDownOutsideCapturedElementとPreviewMouseUpOutsideCapturedElementが発生します。 これにより、キャプチャされた要素は、 MouseDown イベントと MouseUp イベントがルーティングされる前にキャプチャを解放できます。
