cut
Summary
Fires after a data selection is cut to the clipboard.
Overview Table
| Synchronous | No |
|---|---|
| Bubbles | No |
| Target | dom/Element |
| Cancelable | No |
| Default action | ? |
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.
- Invoke the setData method in the oncut event.
Set event.returnValue=false in the oncut event handler to cancel the default action. The default action must be canceled to successfully use the setData method. Web authors can use the innerHTML property or the 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
Syntax
Standards information
There are no standards that apply here.
Event handler parameters
- pEvtObj [in]
- Type: ****IHTMLEventObj****
Attributions
Microsoft Developer Network: [Windows Internet Explorer API reference Article]