push-lisp-clipboard

Function

Package: common-graphics

Arguments: format object

Pushes object onto the clipboard and trims the clipboard to (clipboard-history-limit (configuration *system*)) items if necessary. The new item is also placed into the Windows clipboard, ready to be pasted by other applications.

The format argument should be one of (:text :rich-text :pixmap) and should correspond to the type of object being placed onto the clipboard. Any object may be passed with the :text format, in which case the actual object is placed onto the lisp clipboard stack for pasting within lisp, while a string representation of the object is placed onto the Windows clipboard for pasting into other applications. When using the :rich-text format, the object must be a string which is a valid piece of rich text, and when using the :pixmap format the object must be a Common Graphics pixmap, which is placed onto the Windows clipboard using the "device-independent bitmap" format.

In releases prior to 6.0, the second argument was a window, not a format. A window argument was not useful, while a format argument is. For backward compatibility, if a window or nil is passed as the format, the function will act as if :text were passed.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.