语言

ContentElement.CaptureMouse 方法

定义

尝试将鼠标捕获到此元素。

public:
 virtual bool CaptureMouse();
public bool CaptureMouse();
abstract member CaptureMouse : unit -> bool
override this.CaptureMouse : unit -> bool
Public Function CaptureMouse () As Boolean

返回

true 如果成功捕获鼠标,则为否则,为 false.

实现

示例

以下示例根据元素是否已捕获鼠标来捕获鼠标或释放捕获。 请注意,此示例将潜在捕获目标元素 IInputElement 强制转换为接口,因此最初调用该方法 IInputElement.CaptureMouse 。 IInputElement强制转换是一种技术,如果不确定要捕获鼠标的元素是还是UIElement一种ContentElement,则此方法非常有用。 然后,接口强制转换和接口方法调用在内部调用适当的特定于类型的 CaptureMouse 实现,而无需将试用版强制转换为或UIElementContentElement调用。 这种相同的强制转换技术适用于定义其他成员 IInputElement ,例如许多与输入相关的事件和其他与输入相关的方法。

private void CaptureMouseCommandExecuted(object sender, ExecutedRoutedEventArgs e)
{
  MessageBox.Show("Mouse Command");
  IInputElement target = Mouse.DirectlyOver;

  target = target as Control;
  if (target != null)
  {
    if (!target.IsMouseCaptured)
    {
      Mouse.Capture(target);
    } else {
      Mouse.Capture(null);
    }
  }
}
Private Sub CaptureMouseCommandExecuted(ByVal sender As Object, ByVal e As ExecutedRoutedEventArgs)
  MessageBox.Show("Mouse Command")
  Dim target As IInputElement = Mouse.DirectlyOver

  target = TryCast(target, Control)
  If target IsNot Nothing Then
    If Not target.IsMouseCaptured Then
      Mouse.Capture(target)
    Else
      Mouse.Capture(Nothing)
    End If
  End If
End Sub

注解

若要捕获,必须启用元素。 检查是否 IsEnabled 在 true 调用 CaptureMouse之前。

如果调用 CaptureMouse 返回 true,则 IsMouseCaptured 也是 true。

如果调用CaptureMouse返回,则会true引发事件,GotMouseCapture并在IsMouseCapturedChanged事件数据中报告为调用该方法的RoutedEventArgs.Source元素。CaptureMouse 如果强制捕获,可能会干扰现有捕获 ,尤其是与鼠标拖放相关的捕获。

若要清除所有元素的Mouse.Capture鼠标捕获,请使用提供的参数进行element调用null。

适用于

另请参阅