HTMLWindowEvents4::ondragend Event
.png)
[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
void ondragend( IHTMLEventObj *pEvtObj );
Parameters
- pEvtObj
[in] Pointer to an IHTMLEventObj interface for the current event. This is the same interface returned from IHTMLWindow2::event.
Return Value
No return value.
Event DISPID
DISPID_HTMLWINDOWEVENTS4_ONDRAGENDThe DISPID for this event is defined in mshtmdid.h. Use this value to identify the event handler when implementing IDispatch::Invoke.
Event Information
Bubbles Yes Cancels Yes To invoke Release the mouse button during a drag operation. Default action Calls the associated event handler.
Event Object Properties
The IHTMLEventObj interface contains additional information about the current event. When the ondragend event is fired, you can use the IHTMLWindow2::event property to retrieve an IHTMLEventObj interface. To obtain an alternate interface pointer such as IHTMLEventObj2 or IHTMLEventObj3, call QueryInterface on the object.
Available Properties
IHTMLEventObj::altKey Gets a value that indicates the state of the ALT key. IHTMLEventObj2::altKey Gets a value that indicates the state of the ALT key. IDOMMouseEvent::altKey ![]()
Gets a value that indicates whether the Alt key is pressed. IHTMLEventObj3::altLeft Gets a value that indicates the state of the left ALT key. IHTMLEventObj::clientX Gets the x-coordinate of the mouse pointer's position relative to the client area of the window, excluding window decorations and scroll bars. IHTMLEventObj2::clientX Gets or sets the x-coordinate of the mouse pointer's position relative to the client area of the window, excluding window decorations and scroll bars. IDOMMouseEvent::clientX ![]()
Gets the x-coordinate of the mouse pointer, relative to the upper-left corner of the viewport (that is, the browser's client area). IHTMLEventObj::clientY Gets the y-coordinate of the mouse pointer's position relative to the client area of the window, excluding window decorations and scroll bars. IHTMLEventObj2::clientY Gets or sets the y-coordinate of the mouse pointer's position relative to the client area of the window, excluding window decorations and scroll bars. IDOMMouseEvent::clientY ![]()
Gets the y-coordinate of the mouse pointer, relative to the upper-left corner of the viewport (that is, the browser's client area). IHTMLEventObj::ctrlKey Gets the state of the CTRL key. IHTMLEventObj2::ctrlKey Gets or sets the state of the CTRL key. IDOMMouseEvent::ctrlKey ![]()
Gets a value that indicates whether the Ctrl key is pressed. IHTMLEventObj3::ctrlLeft Sets or retrieves the state of the left CTRL key. IHTMLEventObj2::dataTransfer Retrieves the IHTMLDataTransfer interface pointer of the event object. IDOMDragEvent::dataTransfer ![]()
Retrieves the dataTransfer object associated with the event. IDOMUIEvent::detail ![]()
Retrieves additional detail about the event. IHTMLEventObj::offsetX Gets the x-coordinate of the mouse pointer's position relative to the object firing the event. IHTMLEventObj2::offsetX Gets or sets the x-coordinate of the mouse pointer's position relative to the object firing the event. IHTMLEventObj::offsetY Gets the y-coordinate of the mouse pointer's position relative to the object firing the event. IHTMLEventObj2::offsetY Gets or sets the y-coordinate of the mouse pointer's position relative to the object firing the event. IDOMMouseEvent::relatedTarget ![]()
Gets the secondary element that is involved in an event. IHTMLEventObj::screenX Gets the x-coordinate of the mouse pointer's position relative to the user's screen. IHTMLEventObj2::screenX Gets or sets the x-coordinate of the mouse pointer's position relative to the user's screen. IDOMMouseEvent::screenX ![]()
Gets the x-coordinate of the mouse pointer, relative to the upper-left corner of the screen. IHTMLEventObj::screenY Gets the y-coordinate of the mouse pointer's position relative to the user's screen. IHTMLEventObj2::screenY Gets or sets the y-coordinate of the mouse pointer's position relative to the user's screen. IDOMMouseEvent::screenY ![]()
Gets the y-coordinate of the mouse pointer, relative to the upper-left corner of the screen. IHTMLEventObj3::shiftLeft Retrieves the state of the left SHIFT key. IHTMLEventObj::srcElement Gets the object that fired the event. IHTMLEventObj2::srcElement Gets or sets the object that fired the event. IDOMEvent::srcElement ![]()
Retrieves the element to which the event was originally dispatched. Refer to the specific event object for additional event properties.
Remarks
The HTMLWindowEvents4::ondragend event is the final drag event to fire, following the HTMLWindowEvents4::ondragleave event, which fires on the target object.
See Also