onunload event
Fires immediately before the object is unloaded.
Syntax
HTML Attribute | <element onunload = "handler(event)"> |
Event Property | object.onunload = handler; |
attachEvent Method | object.attachEvent("onunload", handler) |
Event information
Synchronous | No |
Bubbles | No |
Cancelable | No |
Event handler parameters
- pEvtObj [in]
Type: IHTMLEventObj
Standards information
- HTML 4.01 Specification, Section 18.2.3
Remarks
If you call window.IHTMLWindow2::open from this event, the Pop-up Blocker feature in Microsoft Internet Explorer 6 prevents the pop-up window from appearing.
Removes the object or document from the browser window.
To invoke this event, do one of the following:
- Close the current window.
- Navigate to another location by entering a new address or selecting a Favorite.
- Click the Back, Forward, Refresh, or Home button.
- Click an anchor that refers the browser to another document.
- Invoke the anchor.IHTMLElement::click method.
- Invoke the document.IHTMLDocument2::write method.
- Invoke the document.IHTMLDocument2::open method.
- Invoke the document.IHTMLDocument2::close method.
- Invoke the window.IHTMLWindow2::close method.
- Invoke the window.IHTMLWindow2::open method, providing the possible value _self for the window name.
- Invoke the window.IHTMLWindow2::navigate or IShellUIHelper::NavigateAndFind method.
- Invoke the location.IHTMLLocation::replace method.
- Invoke the location.IHTMLLocation::reload method.
- Specify a new value for the location.IHTMLLocation::href property.
- Submit a form to the address specified in the IHTMLFormElement4::action attribute via the INPUT type=submit control, or invoke the form.IHTMLFormElement::submit method.
For security reasons, the HTMLWindowEvents2::onunload event does not open modeless dialog boxes, such as those created with the IHTMLWindow2::alert method or the IHTMLWindow3::showModelessDialog method. This changes affects webpages displayed in IE9 Standards mode or later document modes.
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
See also
Reference
HTMLWindowEvents2::onbeforeunload
Conceptual