Partager via


MouseDevice.Capture Méthode

Définition

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

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

Exceptions

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.

S’applique à

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);
[System.Security.SecurityCritical]
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
[<System.Security.SecurityCritical>]
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
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

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

Attributs

Exceptions

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.

S’applique à