MouseDevice.Capture Méthode

Définition

Espace de noms:

System.Windows.Input

Assembly:

PresentationCore.dll

Capture l'entrée de la souris à l'élément spécifié.

Surcharges

Capture(IInputElement)	Capture des événements de souris à l'élément spécifié.
Capture(IInputElement, CaptureMode)	Capture l'entrée de la souris à l'élément spécifié à l'aide du CaptureModespécifié.

Remarques

Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris, que le curseur se trouve ou non dans ses bordures.

Si un CaptureMode n’est pas spécifié, la valeur par défaut CaptureMode est Element.

Pour libérer la capture de la souris, appelez Capture en tant null qu’élément à capturer.

Si la souris est capturée lorsqu’un MouseDown événement ou MouseUp est déclenché et que l’entrée ne va pas à l’élément sous la souris, PreviewMouseDownOutsideCapturedElement et PreviewMouseUpOutsideCapturedElement qu’elle est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les MouseDown événements et MouseUp ne soient routés.

Capture(IInputElement)

Capture des événements de souris à l'élément spécifié.

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

Paramètres

element

IInputElement

Élément pour capturer la souris.

Retours

Boolean

true si l'élément a pu capturer la souris ; sinon, false.

Exceptions

InvalidOperationException

element n'est ni UIElement ni ContentElement.

Remarques

Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris si le curseur se trouve dans ses bordures

Si un CaptureMode n’est pas spécifié, la valeur par défaut CaptureMode est Element.

Pour libérer la capture de la souris, appelez Capture en tant null qu’élément à capturer.

Si la souris est capturée lorsqu’un MouseDown événement ou MouseUp est déclenché et que l’entrée ne va pas à l’élément sous la souris, PreviewMouseDownOutsideCapturedElement et PreviewMouseUpOutsideCapturedElement qu’elle est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les MouseDown événements et MouseUp ne soient routés.

Capture(IInputElement, CaptureMode)

Capture l'entrée de la souris à l'élément spécifié à l'aide du CaptureModespécifié.

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

Paramètres

element

IInputElement

Élément pour capturer la souris.

captureMode

CaptureMode

Stratégie de capture à utiliser.

Retours

Boolean

true si l'élément a pu capturer la souris ; sinon, false.

Exceptions

InvalidOperationException

element n'est ni UIElement ni ContentElement.

InvalidEnumArgumentException

captureMode n’est pas un CaptureMode valide.

Remarques

Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris, que le curseur se trouve ou non dans ses bordures.

Pour libérer la capture de la souris, appelez Capture en tant null qu’élément à capturer.

Si la souris est capturée lorsqu’un MouseDown événement ou MouseUp est déclenché et que l’entrée ne va pas à l’élément sous la souris, PreviewMouseDownOutsideCapturedElement et PreviewMouseUpOutsideCapturedElement qu’elle est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les MouseDown événements et MouseUp ne soient routés.