Copyright (c) 1990-1992 The Regents of the University of California.
Copyright (c) 1994-1996 Sun Microsystems, Inc.

See the file "license.terms" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.

SCCS: @(#) HandleEvent.3 1.6 96/03/26 18:13:34

.so man.macros S Tk_HandleEvent - invoke event handlers for window system events

#include <tk.h>
Tk_HandleEvent(eventPtr)
 ARGUMENTS
.AS XEvent *eventPtr
.AP XEvent *eventPtr in
Pointer to X event to dispatch to relevant handler(s).
E 
 DESCRIPTION

Tk_HandleEvent is a lower-level procedure that deals with window
events. It is called by Tk_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_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
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