CLEAR PASTEBOARD
CLEAR PASTEBOARD
| Does not require any parameters |
|---|
This command is not thread-safe, it cannot be used in preemptive code.
Description
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.
Example 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
Example 2
See example for the APPEND DATA TO PASTEBOARD command.