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 rele-
vant 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 call-
backs 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_Han-
dleEvent. 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 any-
thing else.
KEYWORDS
callback, event, handler, window
Tk Tk_HandleEvent(3tk)
Generated by dwww version 1.14 on Sat Jan 25 04:33:44 CET 2025.