This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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).
____________________________________________________________________________________________________________


DESCRIPTION
       Tk_HandleEvent  is  a  lower-level procedure that deals with window events.  It is called by Tcl_Ser-viceEvent Tcl_ServiceEvent
       viceEvent (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_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                                                                                         Tk_HandleEvent(3)