ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Copy and paste
Pasting text using a deferred rendering function
Flash Player 10 and later, Adobe AIR 1.0 and later
The following example illustrates how to implement a deferred rendering function.
When the user presses the Copy button, the application clears the system clipboard to ensure that no data is left over
from previous clipboard operations. The setDataHandler() method then sets the renderData() function as the
clipboard renderer.
When the user selects the Paste command from the context menu of the destination text field, the application accesses
the clipboard and sets the destination text. Since the text data format on the clipboard has been set with a function
rather than a string, the clipboard calls the renderData() function. The renderData() function returns the text in
the source text, which is then assigned to the destination text.
Notice that if you edit the source text before pressing the Paste button, the edit will be reflected in the pasted text, even
when the edit occurs after the copy button was pressed. This is because the rendering function doesn’t copy the source
text until the paste button is pressed. (When using deferred rendering in a real application, you might want to store or
protect the source data in some way to prevent this problem.)
Flash example
package {
import flash.desktop.Clipboard;
import flash.desktop.ClipboardFormats;
import flash.desktop.ClipboardTransferMode;
import flash.display.Sprite;
import flash.text.TextField;
import flash.text.TextFormat;
import flash.text.TextFieldType;
import flash.events.MouseEvent;
import flash.events.Event;
public class DeferredRenderingExample extends Sprite
{
private var sourceTextField:TextField;
private var destination:TextField;
private var copyText:TextField;
public function DeferredRenderingExample():void
{
sourceTextField = createTextField(10, 10, 380, 90);
sourceTextField.text = "Neque porro quisquam est qui dolorem "
+ "ipsum quia dolor sit amet, consectetur, adipisci velit.";
copyText = createTextField(10, 110, 35, 20);
copyText.htmlText = "Copy";
copyText.addEventListener(MouseEvent.CLICK, onCopy);
destination = createTextField(10, 145, 380, 90);
destination.addEventListener(Event.PASTE, onPaste);
}
private function createTextField(x:Number, y:Number, width:Number,
height:Number):TextField
{
var newTxt:TextField = new TextField();
newTxt.x = x;
newTxt.y = y;
newTxt.height = height;
Last updated 6/6/2012
601