dblclick | ondblclick event

Fires when the user double-clicks the object.

Note Starting with Internet Explorer 11, this event fires a MSPointerEvent object instead of a MouseEvent. You can use the MouseEvent.pointerType property to determine the type of contact that the click originated from (touch, mouse, or pen).

Syntax

HTML Attribute	<element ondblclick = "handler(event)">
Event Property	object.ondblclick = handler;
attachEvent Method	object.attachEvent("ondblclick", handler)
addEventListener Method	object.addEventListener("dblclick", handler, useCapture)

Event information

Synchronous	No
Bubbles	Yes
Cancelable	Yes

Event handler parameters

pEvtObj [in]: Type: IHTMLEventObj

Standards information

HTML 4.01 Specification, Section 18.2.3

Remarks

The order of events leading to the ondblclick event is onmousedown, onmouseup, onclick, onmouseup, and then ondblclick. Actions associated with any of these events are executed when the ondblclick event fires.

Initiates any action that is associated with the event.

To invoke this event, do one of the following:

Click the left mouse button twice in rapid succession over an object. The user's double-click must occur within the time limit specified by the user's system.

Examples

This example uses the ondblclick event to add items to a list box when the user double-clicks in the text box.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/ondblclickEX.htm

JavaScript



<!DOCTYPE html>
<html>
<head>
<script type="text/javascript">
function addItem()
{
sNewItem = new Option(txtEnter.value)
selList.add(sNewItem);
}
</script>
</head>
<body>
<p>Enter text and then double-click in the text box to
   add text to the list box.</p>
<input type="text" name="txtEnter" value="Enter_text" 
   ondblclick="addItem()"><br><br>
<select name="selList" size="5"></select>
</body>
</html>