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 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 setData method of the dataTransfer object to provide information about data being transferred. Source events include ondragstart, ondrag, and 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:
- HTMLAnchorEvents2
- HTMLAreaEvents2
- HTMLButtonElementEvents2
- HTMLControlElementEvents2
- HTMLDocumentEvents2
- HTMLElementEvents2
- HTMLFormElementEvents2
- HTMLImgEvents2
- HTMLFrameSiteEvents2
- HTMLInputFileElementEvents2
- HTMLInputImageEvents2
- HTMLInputTextElementEvents2
- HTMLLabelEvents2
- HTMLLinkElementEvents2
- HTMLMapEvents2
- HTMLMarqueeElementEvents2
- HTMLObjectElementEvents2
- HTMLOptionButtonElementEvents2
- HTMLScriptEvents2
- HTMLSelectElementEvents2
- HTMLStyleElementEvents2
- HTMLTableEvents2
- HTMLTextContainerEvents2
- HTMLWindowEvents2
- HTMLDocumentEvents4
- HTMLWindowEvents4
See also
Reference
Conceptual
Build date: 1/23/2012