Page 194	Table of Contents	Index	Page 196
	Chapters
	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 A, B, C, D, E

CHAPTER 22. EXTENDED STREAM INPUT

=> abort-gesture-event condition [Generic Function]
Returns the event that cause the abort gesture condition to be signalled. condition is an object
of type abort-gesture.

=> *accelerator-gestures* [Variable]
A list of all of the gesture names that correspond to keystroke accelerators. The global value for
this is nil.

=> accelerator-gesture [Condition]
This condition is signalled by read-gesture whenever an keystroke accelerator gesture (one of
the gestures in *accelerator-gestures* is read from the user.

=> accelerator-gesture-event condition [Generic Function]
Returns the event that cause the accelerator gesture condition to be signalled. condition is an
object of type accelerator-gesture.

=> accelerator-gesture-numeric-argument condition [Generic Function]
Returns the accumlated numeric argument (maintained by the input editor) at the time the ac-
celerator gesture condition was signalled. condition is an object of type accelerator-gesture.

22.3 Gestures and Gesture Names

A gesture is some sort of input action by the user, such as typing a character or clicking a pointer
button. A keyboard gesture refers to those gestures that are input by typing something on the
keyboard. A pointer gesture refers to those gestures that are input by doing something with the
pointer, such as clicking a button.

A gesture name is a symbol that gives a name to a set of similar gestures. Gesture names
are used in order to provide a level of abstraction above raw device events; greater portability
can thus be achieved by avoiding referring directly to platform-dependent constructs, such as
character objects that refer to a particular key on the keyboard. For example, the :completegesture is used to name the gesture that causes the complete-input complete the current input
string; on Genera, this may correspond to the Complete key on the keyboard (which generates
a #\Complete character), but on a Unix workstation, it may correspond to some other key.
Another example is :select, which is commonly used to indicate a left button click on the
pointer.

Note that gesture names participate in a one-to-many mapping, that is, a single gesture name
can name a group of physical gestures. For example, an :edit might include both a pointer
button click and a key press.

CLIM uses event objects to represent user gestures. Some of the more common events are those
of the class pointer-button-event. Event objects store the sheet associated with the event, a

Page 194	Table of Contents	Index	Page 196
	Chapters
	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 A, B, C, D, E