onbeforepaste event
Fires on the target object before the selection is pasted from the system clipboard to the document.
Syntax
HTML Attribute | <element onbeforepaste = "handler(event)"> |
Event Property | object.onbeforepaste = handler; |
attachEvent Method | object.attachEvent("onbeforepaste", handler) |
addEventListener Method | object.addEventListener("beforepaste", handler, useCapture) |
Event information
Synchronous | No |
Bubbles | Yes |
Cancelable | Yes |
Event handler parameters
- pEvtObj [in]
Type: IHTMLEventObj
Standards information
There are no standards that apply here.
Remarks
Creating custom code for pasting requires several steps:
- Set event.returnValue=false in the HTMLTextContainerEvents::onbeforepaste event to enable the Paste shortcut menu item.
- Cancel the default behavior of the client by including event.returnValue=false in the HTMLTextContainerEvents::onpaste event handler. This guideline applies only to objects, such as the text box, that have a defined default behavior.
- Specify a data format in which to paste the selection through the IHTMLDataTransfer::getData method of the clipboardData object.
- Invoke the IHTMLDataTransfer::getData method in the HTMLTextContainerEvents::onpaste event to execute custom code for pasting.
None.
To invoke this event, do one of the following:
- Right-click to display the shortcut menu and select Paste.
- Or press CTRL+V.
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
HTMLTextContainerEvents::onbeforecopy
HTMLTextContainerEvents::onbeforecut
HTMLTextContainerEvents::oncut
HTMLTextContainerEvents::onpaste
Conceptual