Tk_HandleEvent(3)     Tk Library Procedures     Tk_HandleEvent(3)



_________________________________________________________________

NAME
       Tk_HandleEvent  -  invoke event handlers for window system
       events

SYNOPSIS
       #include 

       Tk_HandleEvent(eventPtr)

ARGUMENTS
       XEvent   *eventPtr   (in)      Pointer to X event to  dis-
                                      patch   to   relevant  han-
                                      dler(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 han-
       dlers (created by  calls  to  Tk_CreateEventHandler)  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 noti-
       fier 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(3)