通过

MouseDevice.Capture 方法

  • 参考

定义

命名空间:
System.Windows.Input
程序集:
PresentationCore.dll

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

重载

Capture(IInputElement)

将鼠标事件捕获到指定元素。
Capture(IInputElement, CaptureMode)

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

注解

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

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

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

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

Capture(IInputElement)

将鼠标事件捕获到指定元素。

public:
 bool Capture(System::Windows::IInputElement ^ element);
public bool Capture (System.Windows.IInputElement element);
member this.Capture : System.Windows.IInputElement -> bool
Public Function Capture (element As IInputElement) As Boolean

参数

element
IInputElement

要捕获鼠标的元素。

返回

Boolean

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

例外

InvalidOperationException

element 不是 UIElement 或 ContentElement。

注解

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

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

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

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

适用于

Capture(IInputElement, CaptureMode)

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

public:
 bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);
[System.Security.SecurityCritical]
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
[<System.Security.SecurityCritical>]
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
Public Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

参数

element
IInputElement

要捕获鼠标的元素。

captureMode
CaptureMode

要使用的捕获策略。

返回

Boolean

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

属性
SecurityCriticalAttribute

例外

InvalidOperationException

element 不是 UIElement 或 ContentElement。

InvalidEnumArgumentException

captureMode 不是有效的 CaptureMode。

注解

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

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

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

适用于