Tk_HandleEvent(3)

_________________________________________________________________

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  dis-
                                      patch   to   relevant  han-
                                      dler(s).
_________________________________________________________________

DESCRIPTION
       Tk_HandleEvent is a lower-level procedure that deals  with
       window events.  It is called by Tk_ServiceEvent (and indi-
       rectly by Tk_DoOneEvent), and in a few other cases  within
       Tk.  It makes callbacks to any window event handlers (cre-
       ated  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 Tk_QueueEvent
       followed by Tk_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