MouseDevice.Capture Methode

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Erfasst Mauseingaben für das angegebene Element.

Überlädt

Capture(IInputElement)	Erfasst Mausereignisse 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 kein CaptureMode angegeben ist, ist Elementder Standardwert CaptureMode .

Um die Mauserfassung freizugeben, rufen Sie 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 unterhalb 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 Mausereignisse für das angegebene Element.

public:
 bool Capture(System::Windows::IInputElement ^ element);

public bool Capture (System.Windows.IInputElement element);

member this.Capture : System.Windows.IInputElement -> bool

Public Function Capture (element As IInputElement) As Boolean

Parameter

element

IInputElement

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

Gibt zurück

Boolean

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

Ausnahmen

InvalidOperationException

element ist kein UIElement und keine ContentElement.

Hinweise

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

Wenn kein CaptureMode angegeben ist, ist Elementder Standardwert CaptureMode .

Um die Mauserfassung freizugeben, rufen Sie 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 unterhalb 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, CaptureMode)

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

public:
 bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);

public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);

member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool

Public 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

Boolean

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

Ausnahmen

InvalidOperationException

element ist kein UIElement und keine ContentElement.

InvalidEnumArgumentException

captureMode ist kein gültiger 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.

Um die Mauserfassung freizugeben, rufen Sie 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 unterhalb 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.