Page 294	Table of Contents	Index	Page 296
	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

in the input context input-context. presentation, window, x, y, and stream are as for document- presentation-translator.

Typically pointer documentation will consist of a brief description of each translator that is
applicable to the specified presentation in the specified input context given the current modifier
state for the window. For example, the following documentation might be produced when the
pointer is pointing to a Lisp expression when the input context is form:

Left: '(1 2 3); Middle: (DESCRIBE '(1 2 3)); Right: Menu=> frame-drag-and-drop-feedback frame presentation stream initial-x initial-y new-x new-y state
[Generic Function]
The default feedback function for translators defined by define-drag-and-drop-translator,
which provides visual feedback during the dragging phase of such translators on behalf of the
frame frame. presentation is the presentation being dragged on the stream stream. The pointing
device was initially at the position specified by initial-x and initial-y, and is at the position
specified by new-x and new-y when frame-drag-and-drop-feedback is invoked. (Both positions
are supplied for "rubber-banding", if that is the sort of desired feedback.) state will be either
:highlight, meaning that the feedback should be drawn, or :unhighlight, meaning that the
feedback should be erased.

=> frame-drag-and-drop-highlighting frame presentation stream state [Generic Function]
The default highlighting function for translators defined by define-drag-and-drop-translator,
which is invoked when a "to object" should be highlighted during the dragging phase of such
translators on behalf of the frame frame. presentation is the presentation over which the pointing
device is located on the stream stream. state will be either :highlight, meaning that the high-
lighting for the presentation should be drawn, or :unhighlight, meaning that the highlighting
should be erased.

28.4 The Generic Command Loop

The default application command loop provided by CLIM performs the following steps:

Prompts the user for input.
Reads a command. Each application frame has a command table that contains those
commands that the author of the application wishes to allow the user to invoke at a given
time. Since commands may be read in any number of ways, the generic command loop
enforces no particular interface style.
Executes the command. The definition of each command may refer to (and update) the
state variables of the frame, to which *application-frame* will be bound.
Runs the display function for each pane in the frame as necessary. The display function
may refer to the frame's state variables. Display functions are usually written by the

Page 294	Table of Contents	Index	Page 296
	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