onpaste event
Fires on the target object when the user pastes data, transferring the data from the system clipboard to the document.
Syntax
HTML Attribute | <element onpaste = "handler(event)"> |
Event Property | object.onpaste = handler; |
attachEvent Method | object.attachEvent("onpaste", handler) |
addEventListener Method | object.addEventListener("paste", 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 to enable the Paste command requires several steps.
- Set the event object IHTMLEventObj::returnValue to FALSE in the HTMLScriptEvents2::onbeforepaste event to enable the Paste shortcut menu item.
- Cancel the default behavior of the client by setting the event object IHTMLEventObj::returnValue to FALSE in the HTMLScriptEvents2::onpaste event handler. This applies only to objects, such as the text box, that have a default behavior defined for them.
- Specify a data format in which to paste the selection through the IHTMLDataTransfer::getData method of the clipboardData object.
- Invoke the method in the HTMLScriptEvents2::onpaste event to execute custom paste code.
Inserts the data from the system clipboard into the specified location on the document.
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
HTMLScriptEvents2::onbeforecopy
HTMLScriptEvents2::onbeforecut
HTMLScriptEvents2::onbeforepaste
Conceptual