gesture-spec-to-character Function

Summary

Returns the character corresponding to a gesture-spec.

Package

system

Signature

gesture-spec-to-character gspec &key errorp => char

Arguments

gspec⇩	A gesture-spec.
errorp⇩	A generalized boolean.

Values

char	A Lisp character.

Description

The function gesture-spec-to-character returns the Lisp character object corresponding to gspec.

A gesture-spec with modifiers or data which is not an integer cannot be converted to a character. When supplied such a gesture-spec, gesture-spec-to-character either signals an error (if errorp is true), or returns nil (if errorp is nil). The default value of errorp is t.

gesture-spec-accelerator-bit is ignored.

Compatibility note

In LispWorks 6.1 and earlier versions, gesture-spec-to-character allows modifiers and does not error when the data is not an integer. LispWorks 7.0 and later versions do not support character bits, therefore if gspec contains non-zero modifier bits, gesture-spec-to-character signals an error.

See also

coerce-to-gesture-spec
make-gesture-spec