次の方法で共有


Mouse.Capture メソッド

定義

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

オーバーロード

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

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

戻り値

要素がマウスをキャプチャできた場合は 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

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

戻り値

要素がマウスをキャプチャできた場合は 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解放できます。

適用対象