Mouse.Capture Methode

Definition

Namespace:
System.Windows.Input
Assembly:
PresentationCore.dll

Erfasst Mauseingaben für das angegebene Element.

Überlädt

Name Beschreibung
Capture(IInputElement)

Erfasst Mauseingaben für das angegebene Element.
Capture(IInputElement, CaptureMode)

Erfasst Mauseingaben für das angegebene Element mithilfe des angegebenen CaptureModeElements.

Hinweise

Wenn ein Element die Maus erfasst, empfängt es Mauseingaben, unabhängig davon, ob sich der Cursor innerhalb des Rahmens befindet.

Wenn kein CaptureMode Wert angegeben ist, lautet CaptureModeder Standardwert Element .

Um die Mausaufnahme freizugeben, übergeben Capture Sie den Aufruf null als Element, das erfasst werden soll.

Wenn die Maus erfasst wird, wenn ein MouseDown Ereignis MouseUp ausgelöst wird und die Eingabe nicht zum Element unterhalb der Maus PreviewMouseDownOutsideCapturedElement wechseln wird und PreviewMouseUpOutsideCapturedElement zuerst ausgelöst wird. Auf diese Weise kann das erfasste Element die Aufnahme freigeben, bevor die MouseDownMouseUp Ereignisse 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 zum Erfassen der Maus.

Gibt zurück

Boolean

truewenn das Element die Maus erfassen konnte; andernfalls . false

Beispiele

Das folgende Beispiel zeigt, wie Sie die Maus mithilfe der Capture Methode auf ein bestimmtes Element erfassen.

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 Mauseingaben, unabhängig davon, ob sich der Cursor innerhalb des Rahmens befindet.

Wenn kein CaptureMode Wert angegeben ist, lautet CaptureModeder Standardwert Element .

Um die Mausaufnahme freizugeben, übergeben Capture Sie den Aufruf null als Element, das erfasst werden soll.

Wenn die Maus erfasst wird, wenn ein MouseDown Ereignis MouseUp ausgelöst wird und die Eingabe nicht zum Element unterhalb der Maus PreviewMouseDownOutsideCapturedElement wechseln wird und PreviewMouseUpOutsideCapturedElement zuerst ausgelöst wird. Auf diese Weise kann das erfasste Element die Aufnahme freigeben, bevor die MouseDownMouseUp Ereignisse weitergeleitet werden.

Gilt für:

Capture(IInputElement, CaptureMode)

Erfasst Mauseingaben für das angegebene Element mithilfe des angegebenen CaptureModeElements.

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 zum Erfassen der Maus.

captureMode
CaptureMode

Die zu verwendende Aufnahmerichtlinie.

Gibt zurück

Boolean

truewenn das Element die Maus erfassen konnte; andernfalls . false

Beispiele

Das folgende Beispiel zeigt, wie Sie die Maus mithilfe der Capture Methode auf ein bestimmtes Element erfassen.

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 mauseingaben, ob sich der Cursor innerhalb seines Rahmens befindet.

Um die Mausaufnahme freizugeben, übergeben Capture Sie den Aufruf null als Element, das erfasst werden soll.

Wenn die Maus erfasst wird, wenn ein MouseDown Ereignis MouseUp ausgelöst wird und die Eingabe nicht zum Element unterhalb der Maus PreviewMouseDownOutsideCapturedElement wechseln wird und PreviewMouseUpOutsideCapturedElement zuerst ausgelöst wird. Auf diese Weise kann das erfasste Element die Aufnahme freigeben, bevor die MouseDownMouseUp Ereignisse weitergeleitet werden.

Gilt für: