Mouse.Capture 方法

定义

命名空间:

System.Windows.Input

程序集:

PresentationCore.dll

将鼠标输入捕获到指定的元素。

重载

名称	说明
Capture(IInputElement)	将鼠标输入捕获到指定的元素。
Capture(IInputElement, CaptureMode)	使用指定的元素捕获鼠标输入到指定的 CaptureMode元素。

注解

当元素捕获鼠标时，无论光标是否在其边框内，它都会接收鼠标输入。

如果未指定 a CaptureMode ，则默认值 CaptureMode 为 Element。

若要释放鼠标捕获，请调用 Capture 作为要捕获的元素传递 null 。

如果在引发或事件时MouseDown捕获鼠标，并且输入不会转到鼠标下方的元素，MouseUp并且PreviewMouseDownOutsideCapturedElement首先PreviewMouseUpOutsideCapturedElement引发。 这使捕获的元素有机会在路由和MouseDown事件之前MouseUp释放捕获。

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

注解

当元素捕获鼠标时，无论光标是否在其边框内，它都会接收鼠标输入。

如果未指定 a CaptureMode ，则默认值 CaptureMode 为 Element。

若要释放鼠标捕获，请调用 Capture 作为要捕获的元素传递 null 。

如果在引发或事件时MouseDown捕获鼠标，并且输入不会转到鼠标下方的元素，MouseUp并且PreviewMouseDownOutsideCapturedElement首先PreviewMouseUpOutsideCapturedElement引发。 这使捕获的元素有机会在路由和MouseDown事件之前MouseUp释放捕获。

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 。

如果在引发或事件时MouseDown捕获鼠标，并且输入不会转到鼠标下方的元素，MouseUp并且PreviewMouseDownOutsideCapturedElement首先PreviewMouseUpOutsideCapturedElement引发。 这使捕获的元素有机会在路由和MouseDown事件之前MouseUp释放捕获。