Page 293	Table of Contents	Index	Page 295
	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 28. APPLICATION FRAMES

for its own purposes.

28.3.1 Interface with Presentation Types

This section describes the functions that connect application frames to the presentation type
system. All classes that inherit from application-frame must inherit or implement methods
for all of these functions.

=> frame-maintain-presentation-histories frame [Generic Function]
Returns true if the frame frame maintains histories for its presentations, otherwise returns false.
The default method (on standard-application-frame) returns true if and only if the frame
has at least one interactor pane.

=> frame-find-innermost-applicable-presentation frame input-context stream x y &key event
[Generic Function]
Locates and returns the innermost applicable presentation on the window stream whose sen-
sitivity region contains the point (x;y), on behalf of the frame frame in the input context
input-context. event defaults to nil, and is as for find-innermost-applicable-presentation

The default method (on standard-application-frame) will simply call find-innermost-applicable- presentation.

=> frame-input-context-button-press-handler frame stream button-press-event [Generic Function]
This function is responsible for handling user pointer events on behalf of the frame frame in the
input context *input-context*. stream is the window on which button-press-event took place.

The default implementation (on standard-application-frame) unhighlights any highlighted
presentations, finds the applicable presentation by calling frame-find-innermost-applicable- presentation-at-position, and then calls throw-highlighted-presentation to execute the
translator on that presentation that corresponds to the user's gesture.

If frame-input-context-button-press-handler is called when the pointer is not over any
applicable presentation, throw-highlighted-presentation must be called with a presentation
of *null-presentation*.

=> frame-document-highlighted-presentation frame presentation input-context window x y stream
[Generic Function]
This function is responsible for producing pointer documentation on behalf of the frame frame in
the input context input-context on the window window at the point (x;y). The documentation
is displayed on the stream stream.

The default method (on standard-application-frame) should produce documentation that
corresponds to calling document-presentation-translator on all of the applicable translators

Page 293	Table of Contents	Index	Page 295
	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