ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Copy and paste
Default behavior
Adobe AIR 1.0 and later
By default, AIR copies selected items in response to the copy command, which can be generated either by a keyboard
shortcut or a context menu. Within editable regions, AIR cuts text in response to the cut command or pastes text to
the cursor or selection in response to the paste command.
To prevent the default behavior, your event handler can call the preventDefault() method of the dispatched event
object.
Using the clipboardData property of the event object
Adobe AIR 1.0 and later
The clipboardData property of the event object dispatched as a result of one of the copy or paste events allows you
to read and write clipboard data.
To write to the clipboard when handling a copy or cut event, use the setData() method of the clipboardData object,
passing in the data to copy and the MIME type:
function customCopy(event){
event.clipboardData.setData("text/plain", "A copied string.");
}
To access the data that is being pasted, you can use the getData() method of the clipboardData object, passing in
the MIME type of the data format. The available formats are reported by the types property.
function customPaste(event){
var pastedData = event.clipboardData("text/plain");
}
The getData() method and the types property can only be accessed in the event object dispatched by the paste
event.
The following example illustrates how to override the default copy and paste behavior in an HTML page. The copy
event handler italicizes the copied text and copies it to the clipboard as HTML text. The cut event handler copies the
selected data to the clipboard and removes it from the document. The paste handler inserts the clipboard contents as
HTML and styles the insertion as bold text.
Last updated 6/6/2012
597