Mouse.Capture メソッド

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

パラメーター

返品

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呼び出します。

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

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

パラメーター

返品

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呼び出します。

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