Compartilhar via


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

Standards information

There are no standards that apply here.

Remarks

Creating custom code for pasting requires several steps:

  1. Set event.returnValue=false in the HTMLControlElementEvents::onbeforepaste event to enable the Paste shortcut menu item.
  2. Cancel the default behavior of the client by including event.returnValue=false in the HTMLControlElementEvents::onpaste event handler. This guideline applies only to objects, such as the text box, that have a defined default behavior.
  3. Specify a data format in which to paste the selection through the IHTMLDataTransfer::getData method of the clipboardData object.
  4. Invoke the IHTMLDataTransfer::getData method in the HTMLControlElementEvents::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:

See also

Reference

IHTMLDataTransfer::getData

HTMLControlElementEvents::onbeforecopy

HTMLControlElementEvents::onbeforecut

oncopy

HTMLControlElementEvents::oncut

HTMLControlElementEvents::onpaste

Conceptual

About DHTML Data Transfer