beforepaste | 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
- pEvtObj [in]
-
Type: IHTMLEventObj
Standards information
There are no standards that apply here.
Remarks
Creating custom code for pasting requires several steps:
- Set event.returnValue=false in the onbeforepaste event to enable the Paste shortcut menu item.
- Cancel the default behavior of the client by including event.returnValue=false in the onpaste event handler. This guideline applies only to objects, such as the text box, that have a defined default behavior.
- Specify a data format in which to paste the selection through the getData method of the clipboardData object.
- Invoke the getData method in the 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:
- 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
- a
- address
- applet
- area
- b
- bdo
- big
- blockQuote
- body
- button
- caption
- center
- cite
- code
- custom
- dd
- dfn
- dir
- div
- dl
- dt
- em
- embed
- fieldSet
- font
- form
- hn
- hr
- i
- img
- input type=button
- input type=checkbox
- input type=email
- input type=file
- input type=image
- input type=number
- input type=password
- input type=radio
- input type=range
- input type=reset
- input type=search
- input type=submit
- input type=tel
- input type=text
- input type=url
- kbd
- label
- legend
- li
- listing
- map
- marquee
- menu
- nextID
- noBR
- ol
- p
- plainText
- pre
- rt
- ruby
- s
- samp
- select
- small
- span
- strike
- strong
- sub
- sup
- table
- tBody
- td
- textArea
- tFoot
- th
- tHead
- tr
- tt
- u
- ul
- var
- xmp
- Reference
- getData
- onbeforecopy
- onbeforecut
- oncopy
- oncut
- onpaste
- Conceptual
- About DHTML Data Transfer
Show: