ContentElement.CaptureMouse Methode

public:
 virtual bool CaptureMouse();

public bool CaptureMouse();

abstract member CaptureMouse : unit -> bool
override this.CaptureMouse : unit -> bool

Public Function CaptureMouse () As Boolean

Gibt zurück

truewenn die Maus erfolgreich erfasst wird; andernfalls . false

Implementiert

Beispiele

Im folgenden Beispiel wird die Maus erfasst oder die Aufnahme loslassen, basierend darauf, ob die Maus bereits vom Element erfasst wird. Beachten Sie, dass in diesem Beispiel das potenzielle Aufnahmezielelement in die IInputElement Schnittstelle umgibt und somit zunächst die IInputElement.CaptureMouse Methode aufgerufen wird. Casting to IInputElement is a technique that is useful if you are unsicher whether the element you want to have capture the mouse is a UIElement or a ContentElement. Die Schnittstelle cast und die Schnittstellenmethode rufen dann die entsprechende typspezifische CaptureMouse-Implementierung intern auf, ohne dass eine Testversion in eine UIElement oder ContentElementeine Testversion erforderlich ist. Dieses Umwandlungsverfahren funktioniert für andere Member, die IInputElement definieren, z. B. viele der eingabebezogenen Ereignisse und andere eingabebezogene Methoden.

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

Hinweise

Um erfasst zu werden, muss ein Element aktiviert sein. Überprüfen Sie, ob IsEnabledtrue vor dem Anruf liegt CaptureMouse.

Wenn der Aufruf CaptureMouse zurückgegeben truewird, ist dies IsMouseCaptured auch trueder Wert .

Wenn der Aufruf CaptureMouse zurückgegeben truewird, werden die GotMouseCapture Ereignisse ausgelöst IsMouseCapturedChanged , wobei RoutedEventArgs.Source in den Ereignisdaten als Element gemeldet wird, in dem die CaptureMouse Methode aufgerufen wird. Wenn Sie die Erfassung erzwingen, stören Sie möglicherweise vorhandene Erfassungen – insbesondere bei Aufzeichnungen, die mit drag-and-drop mit der Maus zusammenhängen.

Um die Mausaufnahme von allen Elementen zu löschen, rufen Sie Mouse.Capture den parameter auf, der element als nullangegeben ist.

Weitere Informationen

• IsMouseCaptured