onbeforeprint event
Fires on the object before its associated document prints or previews for printing.
Syntax
HTML Attribute | <element onbeforeprint = "handler(event)"> |
Event Property | object.onbeforeprint = handler; |
attachEvent Method | object.attachEvent("onbeforeprint", handler) |
addEventListener Method | object.addEventListener("beforeprint", handler, useCapture) |
Event information
Synchronous | No |
Bubbles | No |
Cancelable | No |
Event handler parameters
- pEvtObj [in]
Type: IHTMLEventObj
Standards information
There are no standards that apply here.
Remarks
Use this event to modify the document just before it prints or previews for printing. In most cases it is used to make all the information on the document visible just before printing.
Use the event in conjunction with the HTMLWindowEvents2::onafterprint event to undo the changes made to the document in the HTMLWindowEvents2::onbeforeprint event.
Prints the document associated with the object for which the event is specified.
To invoke this event, do one of the following:
- Choose Print or Print Preview from the File menu.
- Press CTRL+P.
- Right-click anywhere on a document, and choose Print.
- Right-click a link on a document, and choose Print.
- From Windows Explorer, select an .htm file and choose Print from the File menu.
- From Windows Explorer, right-click an .htm file and choose Print.
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