Mouse.Capture 方法

定义

命名空间:

System.Windows.Input

程序集:

PresentationCore.dll

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

重载

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

注解

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

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

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

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

Capture(IInputElement)

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

C#

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

参数

element

IInputElement

要捕获鼠标的元素。

返回

Boolean

如果元素能够捕获鼠标，则为 true；否则为 false。

示例

以下示例演示如何使用 Capture 方法将鼠标捕获到特定元素。

C#

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

注解

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

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

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

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

Capture(IInputElement, CaptureMode)

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

C#

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

参数

element

IInputElement

要捕获鼠标的元素。

captureMode

CaptureMode

要使用的捕获策略。

返回

Boolean

如果元素能够捕获鼠标，则为 true；否则为 false。

示例

以下示例演示如何使用 Capture 方法将鼠标捕获到特定元素。

C#

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

注解

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

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

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