UIElement.CaptureMouse 方法

2013/12/13

将触摸输入捕获设置为 UIElement

Namespace:  System.Windows
程序集:  System.Windows(位于 System.Windows.dll 中)

声明
Public Function CaptureMouse As Boolean

返回值

类型: System.Boolean
如果对象具有触摸输入捕获,则返回 true;否则返回 false

对象捕获触摸输入时,不论用户的手指是否位于对象边界区域内,对象都会接收触摸输入。触摸输入只有在执行模拟拖动操作时才会进行捕获。若要释放触摸捕获,请对具有捕获的对象调用 ReleaseMouseCapture 方法。

如果满足以下所有条件,则可以捕获触摸输入:

  • 其他对象不捕获触摸输入。

  • 用户的手指实际接触了屏幕。

如果不满足其中某个条件,则 CaptureMouse 返回值为 false

如果初始 CaptureMouse 调用返回了 true 并且成功捕获了触摸输入,则除非条件已更改,否则对同一对象的后续 CaptureMouse 调用仍将返回 true。如果该对象已具有捕获,则 CaptureMouse 不返回不同的任何内容。根据应用程序的要求,您可能发现设置这样的变量很有用:用于跟踪任意对象是否具有捕获,或提供对当前已具有捕获的特定对象的引用。如果使用此技术,将为每个 CaptureMouse 调用设置该变量并为每个 ReleaseMouseCapture 调用清除该变量。

只有 UIElement 派生对象可以捕获触摸输入。具有可视字符但无法捕获触摸输入的其他对象的显著示例为 Run(只有父 TextBlock 才能捕获)和几何图形(只有父 Path 才能捕获)。

调用 CaptureMouseUIElement 在 UI 中必须为命中测试可见。这意味着 IsHitTestVisible 不能为 false

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示:
© 2015 Microsoft