MouseDevice.Capture Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> boolPublic Function Capture (element As IInputElement) As BooleanParamètres
- element
- IInputElement
Élément pour capturer la souris.
Retours
true si l'élément a pu capturer la souris ; sinon, false.
Exceptions
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.
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 -> boolmember this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> boolPublic Function Capture (element As IInputElement, captureMode As CaptureMode) As BooleanParamè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
element n'est ni UIElement ni ContentElement.
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.
