Page 232	Table of Contents	Index	Page 234
	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 23. PRESENTATION TYPES

window, x, y, and event are as for find-applicable-translators. for-menu, which defaults
to t, is used to decide which of the applicable translators will go into the menu; only those
translators whose :menu option matches menu will be included.

label is either a string to use as a label for the menu, or is nil (the default), meaning the menu
will not be labelled.

23.7.3 Finding Applicable Presentations

=> find-innermost-applicable-presentation input-context window x y &key frame modifier-
state event [Function]
Given an input context input-context, an output recording window stream window, x and y
positions x and y, returns the innermost presentation whose sensitivity region contains x and y
that matches the innermost input context, using the translator matching algorithm described
below. If there is no such presentation, this function will return nil.

event and modifier-state are a pointer button event and modifier state (see event-modifier-
key-state). event defaults to nil, and modifier-state defaults to the current modifier state for
window. Only one of event or modifier-state may be supplied; it is unspecified what will happen
if both are supplied.

frame defaults to the current frame, *application-frame*.

The default method for frame-find-innermost-applicable-presentation will call this function.

=> throw-highlighted-presentation presentation input-context button-press-event [Function]
Given a presentation presentation, input context input-context, and a button press event (which
contains the window, pointer, x and y position of the pointer within the window, the button
pressed, and the modifier state), find the translator that matches the innermost presentation in
the innermost input context, then call the translator to produce an object and a presentation
type. Finally, the matching input context that was established by with-input-context will be
terminated.

Note that it is possible that more than one translator having the same gesture may be applicable
to presentation in the specified input context. In this case, the translator having the highest
priority will be chosen. If there is more than one having the same priority, it is unspecified what
translator will be chosen.

=> highlight-applicable-presentation frame stream input-context &optional prefer-pointer-
window [Function]
This is the core of the "input wait" handler used by with-input-context on behalf of the
application frame frame. It is responsible for locating the innermost applicable presentation
on stream in the input context input-context, unhighlighting presentations that are not appli-

---

Page 232	Table of Contents	Index	Page 234
	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