opensolaris man page for tk_handleevent

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

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 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

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tk is available on http://opensolaris.org.

Tk															       Tk_HandleEvent(3TK)