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 dans l’élément spécifié.
Surcharges
| Nom | Description |
|---|---|
| Capture(IInputElement) |
Capture les événements de souris dans l’élément spécifié. |
| Capture(IInputElement, CaptureMode) |
Capture l’entrée de la souris sur l’élément spécifié à l’aide de l’élément spécifié CaptureMode. |
Remarques
Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris si le curseur se trouve à l’intérieur de 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 le passage null en tant qu’élément à capturer.
Si la souris est capturée lorsqu’un événement ou MouseDown un MouseUp événement est déclenché et que l’entrée ne va pas à l’élément sous la souris et PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les événements et MouseDown les MouseUp événements ne soient routés.
Capture(IInputElement)
Capture les événements de souris dans 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 à capturer.
Retours
true si l’élément a pu capturer la souris ; sinon, false.
Exceptions
element n’est pas un UIElement ou 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 le passage null en tant qu’élément à capturer.
Si la souris est capturée lorsqu’un événement ou MouseDown un MouseUp événement est déclenché et que l’entrée ne va pas à l’élément sous la souris et PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les événements et MouseDown les MouseUp événements ne soient routés.
S’applique à
Capture(IInputElement, CaptureMode)
Capture l’entrée de la souris sur l’élément spécifié à l’aide de l’élément spécifié CaptureMode.
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 à capturer.
- 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 pas un UIElement ou ContentElement.
captureMode n’est pas valide CaptureMode.
Remarques
Lorsqu’un élément capture la souris, il reçoit l’entrée de la souris si le curseur se trouve à l’intérieur de ses bordures.
Pour libérer la capture de la souris, appelez Capture le passage null en tant qu’élément à capturer.
Si la souris est capturée lorsqu’un événement ou MouseDown un MouseUp événement est déclenché et que l’entrée ne va pas à l’élément sous la souris et PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement est déclenchée en premier. Cela permet à l’élément capturé de libérer la capture avant que les événements et MouseDown les MouseUp événements ne soient routés.
