Returns the primary selection.
A displayed CAPI pane or interface.
A string, an image, a Lisp object, or
selection returns the contents of the primary selection as a string, or
nil if there is no selection.
controls what kind of object is read. The following values of
The object is a string. This is the default value.
The object is of type image, converted from whatever format the platform supports.
The object is the Lisp value.
:image, the image returned by
selection is associated with
, so you can free it explicitly with free-image or it will be freed automatically when the pane is destroyed.
On Microsoft Windows there is no notion of selection, so this mechanism is internal to Lisp.
Note that X applications may or may not use the primary selection for their paste operations. For instance, Emacs is configurable by the variable interprogram-paste-function
CAPI User Guide and Reference Manual (Unix version) - 25 Feb 2015