---
title: Element.setCapture()
slug: Web/API/Element/setCapture
tags:
- API
- Capture
- DOM
- Elements
- Méthodes
- Souris
translation_of: Web/API/Element/setCapture
---
{{ APIRef("DOM") }}{{ gecko_minversion_header("2.0") }}
Appelez cette méthode pendant la gestion d'un évènement de la souris pour recibler tous les évènements de la souris sur cet élément jusqu'à ce que le bouton de la souris soit relâché ou que soit appelée {{ domxref("document.releaseCapture()") }}.
## Syntaxe
element.setCapture(retargetToElement);
- `retargetToElement`
- : Si la valeur est `true` (_vrai_), tous les évènements sont ciblés directement vers cet élément ; si elle est `false` (_faux_), les évènements peuvent aussi être déclenchés sur les descendants de cet élément.
## Exemple
Dans cet exemple, les coordonnées en cours de la souris sont dessinées pendant que vous passez la souris après un clic et un appui sur un élément.
```html
Mouse Capture Example
This is an example of how to use mouse capture on elements in Gecko 2.0.
Test Me
No events yet
```
[Voir l'exemple sur une page](/samples/domref/mousecapture.html)
## Notes
L'élément ne peut pas être entièrement déplacé vers le haut ou vers le bas, selon la disposition des autres éléments.
## Spécification
Basé sur l'implémentation Internet Explorer.
## Voir aussi
- {{ domxref("document.releaseCapture()") }}