Freigeben über


Mouse.Capture Methode

Definition

Erfasst Mauseingaben für das angegebene Element.

Überlädt

Capture(IInputElement)

Erfasst Mauseingaben für das angegebene Element.

Capture(IInputElement, CaptureMode)

Erfasst Mauseingaben für das angegebene Element mit dem angegebenen CaptureMode.

Hinweise

Wenn ein Element die Maus erfasst, empfängt es eine Mauseingabe, unabhängig davon, ob sich der Cursor innerhalb seiner Rahmen befindet oder nicht.

Wenn ein CaptureMode nicht angegeben ist, ist Elementder Standardwert CaptureMode .

Rufen Sie zum Freigeben der Mauserfassung Capture die Übergabe null als das zu erfassende Element auf.

Wenn die Maus erfasst wird, wenn ein MouseDown - oder MouseUp -Ereignis ausgelöst wird und die Eingabe nicht an das Element unter der Maus geht und PreviewMouseUpOutsideCapturedElementPreviewMouseDownOutsideCapturedElement zuerst ausgelöst wird. Dadurch kann das erfasste Element die Aufzeichnung freigeben, bevor die MouseDown Ereignisse und MouseUp weitergeleitet werden.

Capture(IInputElement)

Erfasst Mauseingaben für das angegebene Element.

public:
 static bool Capture(System::Windows::IInputElement ^ element);
public static bool Capture (System.Windows.IInputElement element);
static member Capture : System.Windows.IInputElement -> bool
Public Shared Function Capture (element As IInputElement) As Boolean

Parameter

element
IInputElement

Das Element, für das die Maus erfasst werden soll.

Gibt zurück

true, wenn das Element die Maus erfassen konnte, andernfalls false.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Maus mit der Capture -Methode für ein bestimmtes Element erfasst wird.

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}
Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

Hinweise

Wenn ein Element die Maus erfasst, empfängt es eine Mauseingabe, unabhängig davon, ob sich der Cursor innerhalb seiner Rahmen befindet oder nicht.

Wenn ein CaptureMode nicht angegeben ist, ist Elementder Standardwert CaptureMode .

Rufen Sie zum Freigeben der Mauserfassung Capture die Übergabe null als das zu erfassende Element auf.

Wenn die Maus erfasst wird, wenn ein MouseDown - oder MouseUp -Ereignis ausgelöst wird und die Eingabe nicht an das Element unter der Maus geht und PreviewMouseUpOutsideCapturedElementPreviewMouseDownOutsideCapturedElement zuerst ausgelöst wird. Dadurch kann das erfasste Element die Aufzeichnung freigeben, bevor die MouseDown Ereignisse und MouseUp weitergeleitet werden.

Gilt für:

Capture(IInputElement, CaptureMode)

Erfasst Mauseingaben für das angegebene Element mit dem angegebenen CaptureMode.

public:
 static bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);
public static bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
static member Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
Public Shared Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

Parameter

element
IInputElement

Das Element, für das die Maus erfasst werden soll.

captureMode
CaptureMode

Die zu verwendende Erfassungsrichtlinie.

Gibt zurück

true, wenn das Element die Maus erfassen konnte, andernfalls false.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Maus mit der Capture -Methode für ein bestimmtes Element erfasst wird.

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}
Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

Hinweise

Wenn ein Element die Maus erfasst, empfängt es die Mauseingabe, ob sich der Cursor innerhalb seiner Rahmen befindet.

Rufen Sie zum Freigeben der Mauserfassung Capture die Übergabe null als das zu erfassende Element auf.

Wenn die Maus erfasst wird, wenn ein MouseDown - oder MouseUp -Ereignis ausgelöst wird und die Eingabe nicht an das Element unter der Maus geht und PreviewMouseUpOutsideCapturedElementPreviewMouseDownOutsideCapturedElement zuerst ausgelöst wird. Dadurch kann das erfasste Element die Aufzeichnung freigeben, bevor die MouseDown Ereignisse und MouseUp weitergeleitet werden.

Gilt für: