[This documentation is preliminary and is subject to change.]
Fires on the source object when the user releases the mouse at the close of a drag operation.
Syntax
| HTML Attribute | <element ondragend = "handler(event)"> |
|---|---|
| Event Property | object.ondragend = handler; |
| attachEvent Method | object.attachEvent("ondragend", handler) |
| addEventListener Method | object.addEventListener("dragend", 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 ondragend event is the final drag event to fire, following the ondragleave event, which fires on the target object.
Calls the associated event handler.
To invoke this event, do one of the following:
- Release the mouse button during a drag operation.
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
Examples
This example shows when and where each event fires during a drag-and-drop operation by listing each event and the name of the object firing it in a list box.
Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/DragDropEventsEX.htm
<HEAD>
<SCRIPT>
// Code for dynamically adding options to a select.
function ShowResults()
{ // Information about the events
// and what object fired them.
arg = event.type + " fired by " + event.srcElement.id;
var oNewOption = new Option();
oNewOption.text = arg;
oResults.add(oNewOption,0);
}
</SCRIPT>
</HEAD>
<BODY>
<P>Source events are wired up to this text box.</P>
<INPUT ID=txtDragOrigin VALUE="Text to Drag"
ondragstart="ShowResults()"
ondrag="ShowResults()"
ondragend="ShowResults()"
>
<P>Target events are bound to this text box.</P>
<INPUT ID=txtDragDestination VALUE="Drag Destination"
ondragenter="ShowResults()"
ondragover="ShowResults()"
ondragleave="ShowResults()"
ondrop="ShowResults()"
>
<SELECT ID=oResults SIZE=30>
<OPTION>List of Events Fired
</SELECT>
</BODY>
See also
- a
- abbr
- acronym
- address
- area
- audio
- b
- bdo
- big
- blockQuote
- body
- canvas
- caption
- center
- cite
- code
- custom
- dd
- del
- dfn
- dir
- div
- dl
- document
- dt
- em
- fieldSet
- font
- form
- hn
- hr
- i
- img
- input type=button
- input type=checkbox
- input type=file
- input type=image
- input type=password
- input type=radio
- input type=reset
- input type=submit
- input type=text
- kbd
- label
- li
- listing
- map
- marquee
- media
- menu
- noBR
- object
- ol
- p
- plainText
- pre
- q
- s
- samp
- small
- source
- span
- strike
- strong
- sub
- sup
- table
- tBody
- td
- textArea
- tr
- tt
- u
- ul
- var
- video
- window
- xmp
- About DHTML Data Transfer
Build date: 3/14/2012
e.g. drag-drop a CLASS=... Object into an Object that specially has JScript ondragend=...clearAttributes() ...
... leaves the Object appearing to have retained its original styles, margins, though the element itself, its style and said runtimeStyle and currentStyle, are either blank or already-inherited from its style-sheeted Object.... and its appearance does not agree with its various-time style specifications....