Function | Package: cg | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 10.1 Unrevised from 10.0 to 10.1. 10.0 version

## push-lisp-clipboard

Arguments: format object &key empty-os-clipboard

Pushes object onto the clipboard and trims the clipboard to `(clipboard-history-limit (configuration *system*))` items if necessary (see clipboard-history-limit, configuration, and `*system*`).

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.

If a window or `nil` is passed as the format, the function will act as if `:text` were passed. (This behavior maintains backward compatibility with pre-6.0 releases where the second argument had to be a window or `nil`. The window was not useful as an argument, while a format argument is.)

If empty-os-clipboard is true (as it is by default), then the operating system is first cleared of objects of all clipboard formats before adding the new object. This ensures that no other objects are left on the OS clipboard with the new object. If empty-os-clipboard is `nil`, then only the object of the specified format is replaced on the OS clipboard.

See cg-clipboard.htm.

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.

|  | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 10.1 Unrevised from 10.0 to 10.1. 10.0 version