In the functions listed here, the client argument is typically a sheet, but it may be another object that supports event distribution, dispatching, and handling.
port-keyboard-input-focus [Generic Function]
(setf port-keyboard-input-focus) [Generic Function]
Summary: Returns the client to which keyboard events are to be dispatched.
distribute-event [Generic Function]
Summary: The event is distributed to the port 's proper client. In general, this will be the keyboard input focus for keyboard events, and the lowest sheet under the pointer for pointer events.
dispatch-event [Generic Function]
Summary: This function is called to inform a client about an event of interest. It is invoked synchronously by whatever process called process-next-event , so many methods for this function will simply queue the event for later handling. Certain classes of clients and events may cause this function to call either queue-event or handle-event immediately, or else to ignore the event entirely.
queue-event [Generic Function]
Summary: Places the event event into the queue of events for the client client .
handle-event [Generic Function]
Summary: Implements the client's policy with respect to the event. For example, if the programmer wishes to highlight a sheet in response to an event that informs it that the pointer has entered its territory, there would be a method to carry out the policy that specializes the appropriate sheet and event classes.
In addition to queue-event , the queued input protocol handles the following generic functions:
Summary: Takes the next event out of the queue of events for this client.
event-read-no-hang [Generic Function]
Summary: Takes the next event out of the queue of events for this client. It returns nil if there are no events in the queue.
Arguments: client
&optional
event-type
Summary: Returns the next event in the queue without removing it from the queue. If event-type is supplied, events that are not of that type are first removed and discarded.
event-unread [Generic Function]
Summary: Places the event at the head of the client 's event queue, to be the event read next.
event-listen [Generic Function]
Summary: Returns t if there are any events queued for client ; otherwise, it returns nil .
apply-in-sheet-process [Function]
Arguments: sheet function
&rest
args
Summary: Applies function to args on the process that displays sheet .
The function apply-in-sheet-process arranges for function to apply to args (by (apply function args )) on the process that displays sheet .
The application occurs only if sheet is inside a hierarchy of sheets that is currently displayed.
The result is t if apply-in-sheet-process "succeeded", which means it dispatched an event to perform the application. The application may still not happen if the process that display sheet does not reach the point of handling the event (e.g. the user closes the window).
apply-in-sheet-process is especially useful for using the display functions of CLIM (drawing and stream output), which need to happen on the correct process.
`draw-rectangle* sheet 10 10 100 100)
Common Lisp Interface Manager 2.0 User's Guide - 7 Aug 2017