Copy To and From Clipboard

The following methods allow the copying of text and bitmap values to and from the Windows Clipboard.

These methods are available in 3ds Max 2008 and higher.

They were previously available in the Avguard Extensions.

getclipboardText()
setclipboardText <string>

Get/Set the text string in Window's clipboard. getclipboardText() returns a string value, or undefined if the clipboard does not contain a string. setclipboardText() returns true if the string was successfully placed in the clipboard, an integer error code if failed. Error code meanings are:

-1:memory could not be allocated

-2:clipboard could not be opened

-3:clipboard could not be cleared

-4:clipboard could not be set

setclipboardBitmap <bitmap>
getclipboardBitmap()

Get/Set the bitmap in Window's clipboard. getclipboardBitmap() returns a bitmap value, or undefined if the clipboard does not contain a bitmap. setclipboardBitmap() returns true if the bitmap was successfully placed in the clipboard, an integer error code if failed. Error code meanings are:

-1:memory could not be allocated

-2:clipboard could not be opened

-3:clipboard could not be cleared

-4:clipboard could not be set

EXAMPLE

(
local str = "Sorry For The Inconveniences!"
retCode = setclipboardText str
format "Return Code: %\n" retCode
local result = getclipboardText()
if (result != str) then
throw "Clipboard functions didn't work"
else 
format "%\n" result
 
local bm1 = bitmap 100 100 color:red
retCode = setclipboardBitmap bm1
format "Return Code: %\n" retCode
local bm2 = getclipboardBitmap()
display bm2
OK
)

Copy To and From Clipboard

See Also