Fires on the source element when the user copies the object or selection, adding it to the system clipboard.
Syntax
| Inline HTML | <ELEMENT oncopy = "handler" ... >
| All platforms |
|---|
| Event property | object.oncopy = handler | JScript only |
|---|
| object.oncopy = GetRef("handler") | Visual Basic Scripting Edition (VBScript) 5.0 or later only |
| Named script |
<SCRIPT FOR =
object EVENT =
oncopy>
| Internet Explorer only |
|---|
Event Information
| Bubbles | Yes |
|---|
| Cancels | Yes |
|---|
| To invoke | - Right-click to display the shortcut menu and select Copy.
- Or press CTRL+C.
|
|---|
| Default action |
Duplicates the selection. |
|---|
Event Object Properties
Although event handlers in the DHTML Object Model do not receive parameters directly, a handler can query the event object for the following event properties.
Available Properties
| altKey |
Retrieves a value that indicates the state of the ALT key. |
|---|
| altLeft |
Retrieves a value that indicates the state of the left ALT key. |
|---|
| cancelBubble |
Sets or retrieves whether the current event should bubble up the hierarchy of event handlers. |
|---|
| clientX |
Sets or retrieves the x-coordinate of the mouse pointer's position relative to the client area of the window, excluding window decorations and scroll bars. |
|---|
| clientY |
Sets or retrieves the y-coordinate of the mouse pointer's position relative to the client area of the window, excluding window decorations and scroll bars. |
|---|
| ctrlKey |
Sets or retrieves the state of the CTRL key. |
|---|
| ctrlLeft |
Sets or retrieves the state of the left CTRL key.
|
|---|
| dataTransfer |
Provides access to predefined clipboard formats for use in drag-and-drop operations. |
|---|
| offsetX |
Sets or retrieves the x-coordinate of the mouse pointer's position relative to the object firing the event. |
|---|
| offsetY |
Sets or retrieves the y-coordinate of the mouse pointer's position relative to the object firing the event. |
|---|
| returnValue |
Sets or retrieves the return value from the event. |
|---|
| screenX |
Sets or retrieves the x-coordinate of the mouse pointer's position relative to the user's screen. |
|---|
| screenY |
Sets or retrieves the y-coordinate of the mouse pointer's position relative to the user's screen. |
|---|
| shiftKey |
Retrieves the state of the SHIFT key. |
|---|
| shiftLeft |
Retrieves the state of the left SHIFT key.
|
|---|
| srcElement |
Sets or retrieves the object that fired the event. |
|---|
| type |
Sets or retrieves the event name from the event object. |
|---|
| x |
Sets or retrieves the x-coordinate (in pixels) of the mouse pointer's offset from the closest relatively positioned parent element of the element that fired the event. |
|---|
| y |
Sets or retrieves the y-coordinate (in pixels) of the mouse pointer's offset from the closest relatively positioned parent element of the element that fired the event. |
|---|
Remarks
Use the setData method to specify a data format for the selection.
Standards Information
There is no public standard that applies to this event.
Applies To
|
A,
ABBR,
ACRONYM,
ADDRESS,
APPLET,
AREA,
B,
BASE,
BASEFONT,
BDO,
BGSOUND,
BIG,
BLOCKQUOTE,
BODY,
BR,
BUTTON,
CAPTION,
CENTER,
CITE,
CODE,
COL,
COLGROUP,
COMMENT,
CUSTOM,
DD,
DEL,
DFN,
DIR,
DIV,
DL,
DT,
EM,
EMBED,
FIELDSET,
FONT,
FORM,
FRAME,
FRAMESET,
HEAD,
hn,
HR,
HTML,
I,
IFRAME,
IMG,
INPUT type=button,
INPUT type=checkbox,
INPUT type=file,
INPUT type=hidden,
INPUT type=image,
INPUT type=password,
INPUT type=radio,
INPUT type=reset,
INPUT type=submit,
INPUT type=text,
INS,
ISINDEX,
KBD,
LABEL,
LEGEND,
LI,
LINK,
LISTING,
MAP,
MARQUEE,
MENU,
nextID,
NOBR,
NOFRAMES,
NOSCRIPT,
OBJECT,
OL,
OPTION,
P,
PLAINTEXT,
PRE,
Q,
RT,
RUBY,
S,
SAMP,
SCRIPT,
SELECT,
SMALL,
SPAN,
STRIKE,
STRONG,
SUB,
SUP,
TABLE,
TBODY,
TD,
TEXTAREA,
TFOOT,
TH,
THEAD,
TITLE,
TR,
TT,
U,
UL,
VAR,
WBR,
XML,
XMP,
Element Constructor |
See Also