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);

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

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。

例外

InvalidOperationException

element 不是 UIElement 或 ContentElement。

InvalidEnumArgumentException

captureMode 不是有效的 CaptureMode。

注解

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

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

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