files/es/web/api/element/setcapture/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

---
title: Element.setCapture()
slug: Web/API/Element/setCapture
tags:
  - API
  - DOM
  - Element
  - Método(2)
  - Referencia
translation_of: Web/API/Element/setCapture
---
<p>{{ APIRef("DOM") }}{{ gecko_minversion_header("2.0") }}</p>

<p><span id="result_box" lang="es"><span>Llame a este método durante el manejo de un evento mousedown para redirigir todos los eventos de mouse a este elemento hasta que se suelte el botón del mouse o se llame {{domxref ( "document.releaseCapture ()")}}.</span></span></p>

<h2 id="Syntax" name="Syntax">Sintasix</h2>

<pre class="eval">element.setCapture(<em>retargetToElement</em>);
</pre>

<dl>
 <dt><code>retargetToElement</code></dt>
 <dd><span id="result_box" lang="es">     <span>Si es verdadero, todos los eventos se dirigen directamente a este elemento;</span> <span>Si es falso, los eventos también pueden descargar a los descendientes de este elemento.</span></span></dd>
</dl>

<h2 id="Example" name="Example">Ejemplo</h2>

<p><span id="result_box" lang="es"><span>En este ejemplo, las coordenadas actuales del mouse se dibujan mientras situas el mouse alrededor después de hacer clic y mantener pulsado un elemento.</span></span></p>

<pre class="brush: html">&lt;html&gt;
&lt;head&gt;
  &lt;title&gt;Mouse Capture Example&lt;/title&gt;
  &lt;style type="text/css"&gt;
    #myButton {
      border: solid black 1px;
      color: black;
      padding: 2px;
      -moz-box-shadow:black 2px 2px;
    }
  &lt;/style&gt;

  &lt;script type="text/javascript"&gt;
    function init() {
      var btn = document.getElementById("myButton");
      btn.addEventListener("mousedown", mouseDown, false);
      btn.addEventListener("mouseup", mouseUp, false);
    }

    function mouseDown(e) {
      e.target.setCapture();
      e.target.addEventListener("mousemove", mouseMoved, false);
    }

    function mouseUp(e) {
      e.target.removeEventListener("mousemove", mouseMoved, false);
    }

    function mouseMoved(e) {
      var output = document.getElementById("output");
      output.innerHTML = "Position: " + e.clientX + ", " + e.clientY;
    }
  &lt;/script&gt;
&lt;/head&gt;
&lt;body onload="init()"&gt;
  &lt;p&gt;This is an example of how to use mouse capture on elements in Gecko 2.0.&lt;/p&gt;
  &lt;p&gt;&lt;a id="myButton" href="#"&gt;Test Me&lt;/a&gt;&lt;/p&gt;
  &lt;div id="output"&gt;No events yet&lt;/div&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>

<p><a href="/samples/domref/mousecapture.html">Ver ejemplo en vivo</a></p>

<h2 id="Notes" name="Notes">Notas</h2>

<p><span id="result_box" lang="es"><span>El elemento no puede desplazarse completamente hacia arriba o hacia abajo dependiendo del diseño de otros elementos.</span></span></p>

<h2 id="Specification" name="Specification">Especificación</h2>

<p>Ninguna.</p>

<h2 id="Ver_también">Ver también</h2>

<ul>
 <li>{{ domxref("document.releaseCapture()") }}</li>
</ul>