Tk_HandleEvent - invoke event handlers for window system events
#include <tk.h> Tk_HandleEvent(eventPtr)
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
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_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
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/tk-8 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://source-
forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.
Further information about this software can be found on the open source
community website at https://www.tcl.tk/.
Tk Tk_HandleEvent(3tk)