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 Tcl_ServiceEvent (and
indirectly by Tk_DoOneEvent), and in a few other cases
within Tk. It makes callbacks to any window event han
dlers (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 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
Man(1) output converted with
man2html