CLEAR PASTEBOARD

version 11 (Modified)

CLEAR PASTEBOARD

The CLEAR PASTEBOARD command clears the pasteboard of all its contents. If the pasteboard contains multiple instances of the same data, all instances are cleared. After a call to CLEAR PASTEBOARD, the pasteboard is empty.

You must call CLEAR PASTEBOARD once before appending new data to the pasteboard using the command APPEND DATA TO PASTEBOARD, because this latter command does not clear the pasteboard before appending the new data.

Calling CLEAR PASTEBOARD once and then calling APPEND DATA TO PASTEBOARD several times enables you to Cut or Copy the same data under different formats.

On the other hand, the SET TEXT TO PASTEBOARD and SET PICTURE TO PASTEBOARD commands automatically clear the pasteboard before appending the data to it.

1. The following code clears and then appends data to the pasteboard:

   CLEAR PASTEBOARD  ` Make sure the pasteboard is emptied
   APPEND DATA TO PASTEBOARD("com.4d.private.picture.gif";$vxSomeData)  ` Add some gif pictures
   APPEND DATA TO PASTEBOARD("com.4d.private.text.rtf";$vxSylkData)  ` Add some RTF text

2. See example for the APPEND DATA TO PASTEBOARD command.

APPEND DATA TO PASTEBOARD.