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)

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

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

注解

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

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

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

如果在引发 或 事件时MouseDown捕获了鼠标，并且输入不会转到鼠标下方的 元素，PreviewMouseDownOutsideCapturedElement则PreviewMouseUpOutsideCapturedElement首先MouseUp引发 。 这使捕获的元素有机会在路由 和 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

要使用的捕获策略。

返回

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 passing null 作为要捕获的元素。

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