Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ondrop event

Fires on the target object when the mouse button is released during a drag-and-drop operation.

Syntax

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

Event information

SynchronousNo
BubblesYes
CancelableYes

Event handler parameters

pEvtObj [in]

Type: IHTMLEventObj

Standards information

There are no standards that apply here.

Remarks

The HTMLAreaEvents::ondrop event fires before the HTMLAreaEvents::ondragleave and HTMLAreaEvents::ondragend events.

When scripting custom functionality, use the IHTMLEventObj::returnValue property to disable the default action.

You must cancel the default action for HTMLAreaEvents::ondragenter and HTMLAreaEvents::ondragover in order for HTMLAreaEvents::ondrop to fire. In the case of a div, the default action is not to drop. This can be contrasted with the case of an input type=text element, where the default action is to drop. In order to allow a drag-and-drop action on a div, you must cancel the default action by specifying window.event.returnValue=false in both the HTMLAreaEvents::ondragenter and HTMLAreaEvents::ondragover event handlers. Only then will HTMLAreaEvents::ondrop fire.

As of Microsoft Internet Explorer 5, drag-and-drop events can be used to carry out drag-and-drop activities, not only with input type=text elements, but also with block and inline tags. For example, text can be selected, dragged, then dropped on a div target. This causes several target events to fire, including HTMLAreaEvents::ondragenter, HTMLAreaEvents::ondragover, and HTMLAreaEvents::ondrop. Because drag-and-drop actions are not directly supported on block and inline tags, you must use extra scripting to carry out the move or copy to the target using IHTMLElement::innerText, for example.

Calls the associated event handler.

To invoke this event, do one of the following:

  • Drag the selection over a valid drop target and release the mouse.

See also

About DHTML Data Transfer

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.