MouseDevice.Capture メソッド

定義

指定された要素に対するマウス入力をキャプチャします。

オーバーロード

Capture(IInputElement)

指定された要素に対するマウス イベントをキャプチャします。

Capture(IInputElement, CaptureMode)

指定した CaptureMode を使用して、指定された要素に対するマウス入力をキャプチャします。

注釈

要素がマウスをキャプチャすると、カーソルが境界線内にあるかどうかにかかわらず、マウス入力を受け取ります。

CaptureMode 指定されていない場合、既定値 CaptureMode は です Element

マウス キャプチャを解放するには、キャプチャする要素として を 呼び出 Capture します null

または MouseUp イベントが発生したときにMouseDownマウスがキャプチャされ、入力がマウスの下の要素に移動せず、 PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement最初に発生する場合。 これにより、キャプチャされた要素は、 イベントと MouseUp イベントがルーティングされる前にキャプチャをMouseDown解放できます。

Capture(IInputElement)

指定された要素に対するマウス イベントをキャプチャします。

public:
 bool Capture(System::Windows::IInputElement ^ element);
public bool Capture (System.Windows.IInputElement element);
member this.Capture : System.Windows.IInputElement -> bool
Public Function Capture (element As IInputElement) As Boolean

パラメーター

element
IInputElement

マウスをキャプチャする要素。

戻り値

要素がマウスをキャプチャできた場合は true。それ以外の場合は false

例外

elementUIElement または ContentElement ではありません。

注釈

要素がマウスをキャプチャすると、カーソルが境界線内にあるかどうかに関するマウス入力を受け取ります

CaptureMode 指定されていない場合、既定値 CaptureMode は です Element

マウス キャプチャを解放するには、キャプチャする要素として を 呼び出 Capture します null

または MouseUp イベントが発生したときにMouseDownマウスがキャプチャされ、入力がマウスの下の要素に移動せず、 PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement最初に発生する場合。 これにより、キャプチャされた要素は、 イベントと MouseUp イベントがルーティングされる前にキャプチャをMouseDown解放できます。

適用対象

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 -> bool
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
Public Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

パラメーター

element
IInputElement

マウスをキャプチャする要素。

captureMode
CaptureMode

使用するキャプチャ ポリシー。

戻り値

要素がマウスをキャプチャできた場合は true。それ以外の場合は false

属性

例外

elementUIElement または ContentElement ではありません。

captureMode は有効な CaptureMode ではありません。

注釈

要素がマウスをキャプチャすると、カーソルが境界線内にあるかどうかにかかわらず、マウス入力を受け取ります。

マウス キャプチャを解放するには、キャプチャする要素として を 呼び出 Capture します null

または MouseUp イベントが発生したときにMouseDownマウスがキャプチャされ、入力がマウスの下の要素に移動せず、 PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement最初に発生する場合。 これにより、キャプチャされた要素は、 イベントと MouseUp イベントがルーティングされる前にキャプチャをMouseDown解放できます。

適用対象