Tk_HandleEvent(3) Tk Library Procedures Tk_HandleEvent(3)
NAME
Tk_HandleEvent - invoke event handlers for window system events
SYNOPSIS
#include <tk.h>
Tk_HandleEvent(eventPtr)
ARGUMENTS
Pointer to X event to dispatch to relevant handler(s).
DESCRIPTION
Tk_HandleEvent is a lower-level procedure that deals with window
events. It is called by Tcl_ServiceEvent (and indirectly by
Tk_DoOneEvent), and in a few other cases within Tk. It makes callbacks
to any window event handlers (created by calls to Tk_CreateEven-
tHandler) that match eventPtr and then returns. In some cases it may
be useful for an application to bypass the Tk event queue and call
Tk_HandleEvent directly instead of calling Tcl_QueueEvent followed by
Tcl_ServiceEvent.
This procedure may be invoked recursively. For example, it is possible
to invoke Tk_HandleEvent recursively from a handler called by Tk_Han-
dleEvent. This sort of operation is useful in some modal situations,
such as when a notifier has been popped up and an application wishes to
wait for the user to click a button in the notifier before doing any-
thing else.
KEYWORDS
callback, event, handler, window
Tk Tk_HandleEvent(3)
HandleEvent 8.5.4 - Generated Sat Aug 23 18:52:49 CDT 2008