Page 229 Table of Contents Index Page 231
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

feedback.

When the "from presentation" is dragged over any other presentation that has a direct ma-
nipulation translator, the function specified by highlighting is invoked to highlight that object.
The function is called with four arguments: the application frame object, the "to presentation"
to be highlighted or unhighlighted, the stream, and a highlighting state (either :highlight or
:unhighlight). highlighting defaults to frame-drag-and-drop-highlighting.

Note that it is possible for there to be more than one drag and drop translator that applies
to the same from-type, to-type, and gesture. In this case, the exact translator that is chosen
for use during the dragging phase is unspecified. If these translators have different feedback,
highlighting, documentation, or pointer documentation, the exact behavior is unspecified.

The other arguments to define-drag-and-drop-translator are the same as for define-
presentation-translator
.

23.7.2 Presentation Translator Functions

=> find-presentation-translators from-type to-type command-table [Function]
Returns a list of all of the translators in the command table command-table that translate from
from-type to to-type, without taking into account any type parameters or testers. from-type
and to-type are presentation type specifiers, and must not be abbreviations. frame must be an
application frame.

Implementation note: Because find-presentation-translators is called during pointer
sensitivity computations (that is, whenever the user mouses the pointer around in any CLIM
pane), it should cache its result in order to avoid consing. Therefore, the resulting list of
translators should not be modified; the consequences of doing so are unspecified.

=> test-presentation-translator translator presentation context-type frame window x y &key
event modifier-state for-menu [Function]
Returns true if the translator translator applies to the presentation presentation in input context
type context-type, otherwise returns false. (There is no from-type argument because it is derived
from presentation.) x and y are the x and y positions of the pointer within the window stream
window.

event and modifier-state are a pointer button event and modifier state (see event-modifier-
key-state
), and are compared against the translator's gesture. event defaults to nil, and
modifier-state defaults to 0, meaning that no modifier keys are held down. Only one of event or
modifier-state may be supplied; it is unspecified what will happen if both are supplied.

If for-menu is true, the comparison against event and modifier-state is not done.

presentation, context-type, frame, window, x, y, and event are passed along to the translator's
tester if and when the tester is called.


Page 229 Table of Contents Index Page 231
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