The function
clipboard
returns the contents of the system clipboard as a string, or
nil
if the clipboard is empty.
format controls what kind of object is read. The following values of format are recognized:
The object is a string. This the default value.
The object is of type image, converted from whatever format the platform supports.
The object is the Lisp value.
When
format
is
:image
, the image returned by clipboard is associated with
self
, so you can free it explicitly with free-image or it will be freed automatically when the pane is destroyed.
The Windows clipboard is usually set by the user with the
Ctrl+C
and
Ctrl+X
gestures. Note that LispWorks uses these gestures when in Windows emulation mode.
On X, various gestures may set the clipboard. The X clipboard can be accessed by running the program
xclipboard
or the Emacs function
x-get-clipboard
.