MouseDevice.Capture 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将鼠标输入捕获到指定的元素。
重载
| 名称 | 说明 |
|---|---|
| Capture(IInputElement) |
将鼠标事件捕获到指定的元素。 |
| Capture(IInputElement, CaptureMode) |
使用指定的元素捕获鼠标输入到指定的 CaptureMode元素。 |
注解
当元素捕获鼠标时,无论光标是否在其边框内,它都会接收鼠标输入。
如果未指定 a CaptureMode ,则默认值 CaptureMode 为 Element。
若要释放鼠标捕获,请调用 Capture 作为要捕获的元素传递 null 。
如果在引发或事件时MouseDown捕获鼠标,并且输入不会转到鼠标下方的元素,MouseUp并且PreviewMouseDownOutsideCapturedElement首先PreviewMouseUpOutsideCapturedElement引发。 这使捕获的元素有机会在路由和MouseDown事件之前MouseUp释放捕获。
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
要捕获鼠标的元素。
返回
true 如果元素能够捕获鼠标,则为否则,为 false.
例外
element 不是 UIElement 或 ContentElement。
注解
当元素捕获鼠标时,它会接收鼠标输入,无论光标是否在其边框内
如果未指定 a CaptureMode ,则默认值 CaptureMode 为 Element。
若要释放鼠标捕获,请调用 Capture 作为要捕获的元素传递 null 。
如果在引发或事件时MouseDown捕获鼠标,并且输入不会转到鼠标下方的元素,MouseUp并且PreviewMouseDownOutsideCapturedElement首先PreviewMouseUpOutsideCapturedElement引发。 这使捕获的元素有机会在路由和MouseDown事件之前MouseUp释放捕获。
适用于
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
要使用的捕获策略。
返回
true 如果元素能够捕获鼠标,则为否则,为 false.
- 属性
例外
element 不是 UIElement 或 ContentElement。
captureMode 不是有效的 CaptureMode。
注解
当元素捕获鼠标时,无论光标是否在其边框内,它都会接收鼠标输入。
若要释放鼠标捕获,请调用 Capture 作为要捕获的元素传递 null 。
如果在引发或事件时MouseDown捕获鼠标,并且输入不会转到鼠标下方的元素,MouseUp并且PreviewMouseDownOutsideCapturedElement首先PreviewMouseUpOutsideCapturedElement引发。 这使捕获的元素有机会在路由和MouseDown事件之前MouseUp释放捕获。