selection-empty

selection-empty Function

Summary

Determines whether there is a primary selection of a particular kind.

Package

capi

Signature

selection-empty self &optional format => result, owner

Arguments

`self`⇩	A displayed CAPI pane or interface.
`format`⇩	A keyword.

Values

`result`	`t` or `nil`.
`owner`⇩	One of `:lisp`, `t` or `nil`.

Description

The function selection-empty returns nil if there is a primary selection of the kind indicated by format associated with self, or t if there is no such selection.

The second return value owner is :lisp when the primary selection is owned by LispWorks, t when it is owned by some other application and nil when it is empty.

format controls what kind of object is checked. The following values of format are recognized:

`:string`	The object is a string. This is the default value.
`:image`	The object is of type image, converted from whatever format the platform supports.
`:value`	The object is the Lisp value.