Tk_HandleEvent(3tk)					       Tk Library Procedures					       Tk_HandleEvent(3tk)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_HandleEvent - invoke event handlers for window system events

SYNOPSIS

       #include <tk.h>

       Tk_HandleEvent(eventPtr)

ARGUMENTS

       XEvent *eventPtr (in)	      Pointer  to X event to dispatch to relevant handler(s). It is important that all unused fields of the struc-
				      ture be set to zero.
_________________________________________________________________

DESCRIPTION

       Tk_HandleEvent is a lower-level	procedure  that  deals	with  window  events.	It  is	called	by  Tcl_ServiceEvent  (and  indirectly	by
       Tcl_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_HandleEvent.	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 anything else.

KEYWORDS

       callback, event, handler, window

Tk															       Tk_HandleEvent(3tk)