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.
The object is a metafile.
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.
When
format
is
:metafile
the object is a metafile which should be freed using free-metafile when no longer needed. See also draw-metafile and draw-metafile-to-image.
format
:metafile
is not supported on X11/Motif.
The Microsoft 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 X11/Motif, various gestures may set the clipboard. Note that LispWorks uses
Ctrl+C
and
Ctrl+X
when in KDE/Gnome editor emulation mode. The X clipboard can also be accessed by running the program
xclipboard
or the Emacs function
x-get-clipboard
.
The Mac OS X clipboard is usually set by the user with the
Command+C
and
Command+X
gestures.
clipboard-empty
draw-metafile
draw-metafile-to-image
free-image
free-metafile
image
selection
set-clipboard
text-input-pane-paste