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 。

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

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 。

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