NextPrevUpTopContentsIndex

set-clipboard

Function
Summary

Sets the contents of the system clipboard.

Package

capi

Signature

set-clipboard self value &optional string plist => result

Arguments

self

A displayed CAPI pane or interface.

value

A Lisp object (not necessarily a string) to make available within the local Lisp image.

string

The string representation of value to export, or nil . If nil and value is a string, then that will be exported as the string.

plist

A property list of additional format/value pairs to export. The currently supported formats are :string , whose value should be a string, and :image whose value should be an image object. This allows you to export more than one format simultaneously.

Values

result

A string, or nil .

Description

The function set-clipboard sets the contents of the system clipboard to be the text of string .

In Windows applications (including LispWorks in Windows emulation mode), the contents of the system clipboard is usually accessed by the user with the Ctrl+V gesture.

The X clipboard can be accessed by running the program xclipboard or the Emacs function x-get-clipboard. The most likely explanation for apparent inconsistencies after set-clipboard is that the pasting application doesn't use the X clipboard.

Example

To export an image:

(capi:set-clipboard pane nil nil (list :image image ))

To export an image with a text description

(capi:set-clipboard pane
 nil nil
                    (list :image image
 
                          :string "my image"))
See also

clipboard
selection


LispWorks CAPI Reference Manual - 11 Apr 2005

NextPrevUpTopContentsIndex