beforecopy | onbeforecopy event (Internet Explorer)

The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

1 out of 2 rated this helpful - Rate this topic

Fires on the source object before the selection is copied to the system clipboard.

Syntax

HTML Attribute	<element onbeforecopy = "handler(event)">
Event Property	object.onbeforecopy = handler;
attachEvent Method	object.attachEvent("onbeforecopy", handler)
addEventListener Method	object.addEventListener("beforecopy", 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

The onbeforecopy event fires on the source element. Use the setData method to specify a data format for the selection.

None.

To invoke this event, do one of the following:

Right-click to display the shortcut menu and select Copy.
Or press CTRL+C.

The pEvtObj parameter is required for the following interfaces:

Examples

This example uses the onbeforecopy event to customize copy behavior.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/onbeforecopyEX.htm


<HEAD>
<SCRIPT>
var sNewValue = "copy event fired";
var bFired = false;
var sSave = "";
function Source_Beforecopy() 
{
  sSave = oSource.innerText;
  bFired = true;
  event.returnValue = false;
}
function Source_Copy() 
{
  window.clipboardData.setData("Text", sNewValue);
}
function Target_BeforePaste() 
{
  event.returnValue = false;
}
function Target_Paste() 
{
  event.returnValue = false;
  oTarget.value = window.clipboardData.getData("Text");
}
</SCRIPT>
</HEAD>
<BODY>
<SPAN ID=oSource onbeforecopy="Source_Beforecopy()"
       oncopy="Source_Copy()">copy this text</SPAN>
<INPUT ID=oTarget onbeforepaste="Target_BeforePaste()"
       onpaste="Target_Paste()">
</BODY>

beforecopy | onbeforecopy event