MouseDevice.Capture メソッド

定義

名前空間:

System.Windows.Input

アセンブリ:

PresentationCore.dll

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

オーバーロード

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

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

戻り値

Boolean

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

例外

InvalidOperationException

element が UIElement または 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);

public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);

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

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

戻り値

Boolean

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

例外

InvalidOperationException

element が UIElement または ContentElement ではありません。

InvalidEnumArgumentException

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

注釈

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

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

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