beforecut | onbeforecut 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.

This topic has not yet been rated - Rate this topic

Fires on the source object before the selection is deleted from the document.

Syntax

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

Creating custom code for cutting requires several steps:

Set event.returnValue=false in the onbeforecut event to enable the Cut shortcut menu item.
Specify a data format in which to transfer the selection through the setData method of the clipboardData object.
Invoke the setData method in the oncut event.

None.

To invoke this event, do one of the following:

Right-click to display the shortcut menu and select Cut.
Or press CTRL+X if the selection is within a text field.

The pEvtObj parameter is required for the following interfaces:

Examples

This example uses the setData and getData methods with the clipboardData object to perform a cut-and-paste operation through the shortcut menu.

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


<head>
<script>
var sSave = "";
function fnBeforeCut() {
   event.returnValue = false;
}
function fnCut() {
   event.returnValue = false;
   sSave = oSource.innerText;
   oSource.innerText = "";
}
function fnBeforePaste() {
   event.returnValue = false;
}
function fnPaste() {
   event.returnValue = false;
   oTarget.innerText = sSave;
}
</script>
</head>
<body>
<div id="oSource" class="selectandcut" 
    onbeforecut="fnBeforeCut()" 
    oncut="fnCut()">Select and Cut this Text 
</div>
<br>
<br>
<div id="oTarget" class="pastehere" 
    onbeforepaste="fnBeforePaste()" 
    onpaste="fnPaste()">Paste the Text Here 
</div>
</body>

beforecut | onbeforecut event