This topic has not yet been rated - Rate this topic

ondragstart event

[This documentation is preliminary and is subject to change.]

Fires on the source object when the user starts to drag a text selection or selected object.

Syntax

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

Standards information

There are no standards that apply here.

Event information

Synchronous	No
Bubbles	No
Cancelable	No

Event handler parameters

pEvtObj [in]: Type: IHTMLEventObj

Remarks

The HTMLDocumentEvents2::ondragstart event is the first to fire when the user starts to drag the mouse. It is essential to every drag operation, yet is just one of several source events in the data transfer object model. Source events use the IHTMLDataTransfer::setData method of the dataTransfer object to provide information about data being transferred. Source events include HTMLDocumentEvents2::ondragstart, HTMLFrameSiteEvents::ondrag, and HTMLFrameSiteEvents::ondragend.

When dragging anything other than an img object, some text to be dragged must be selected.

Calls the associated event handler.

To invoke this event, do one of the following:

Drag the selected text or object.

The pEvtObj parameter is required for the following interfaces: