Tk_HandleEvent(3)

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

     XEvent *eventPtr (in)          Pointer   to   X   event   to
                                    dispatch      to     relevant
                                    handler(s). It  is  important
                                    that all unused fields of the
                                    structure 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_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 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                        Last change:                          1