Mouse.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:
 static bool Capture(System::Windows::IInputElement ^ element);

public static bool Capture (System.Windows.IInputElement element);

static member Capture : System.Windows.IInputElement -> bool

Public Shared Function Capture (element As IInputElement) As Boolean

パラメーター

element

IInputElement

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

戻り値

Boolean

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

例

次の例は、 メソッドを使用して特定の要素にマウスをキャプチャする方法を Capture 示しています。

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}

Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

注釈

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

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

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

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

Capture(IInputElement, CaptureMode)

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

public:
 static bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);

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

static member Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool

Public Shared Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

パラメーター

element

IInputElement

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

captureMode

CaptureMode

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

戻り値

Boolean

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

例

次の例は、 メソッドを使用して特定の要素にマウスをキャプチャする方法を Capture 示しています。

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}

Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

注釈

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

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

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