oncut event
Fires on the source element when the object or selection is removed from the document and added to the system clipboard.
Syntax
HTML Attribute | <element oncut = "handler(event)"> |
Event Property | object.oncut = handler; |
attachEvent Method | object.attachEvent("oncut", handler) |
addEventListener Method | object.addEventListener("cut", 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 cutting requires several steps:
- Set event.returnValue=false in the HTMLMapEvents2::onbeforecut event to enable the Cut shortcut menu item.
- Specify a data format in which to transfer the selection through the IHTMLDataTransfer::setData method of the clipboardData object.
- Invoke the IHTMLDataTransfer::setData method in the HTMLMapEvents2::oncut event.
Set event.returnValue=false in the HTMLMapEvents2::oncut event handler to cancel the default action. The default action must be canceled to successfully use the IHTMLDataTransfer::setData method. Web authors can use the IHTMLElement::innerHTML property or the IHTMLSelectionObject::createRange method to perform the cut operation once the event is canceled.
Removes the selection from the document and persists it in the clipboard.
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:
- 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
Conceptual