Function

Summary

Sets the primary selection.

Package

capi

Signature

set-selection 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 a image object. This allows you to export more than one format simultaneously.

Values

result

A string, or nil .

Description

The function set-selection sets the primary selection to be the text of string .

On 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. The most likely explanation for apparent inconsistencies after set-selection is that the pasting application doesn't use the primary selection. For instance, Emacs is configurable by the variable interprogram-paste-function.

See also

selection
set-clipboard