Tk Library Procedures Tk_HandleEvent(3TK)
_________________________________________________________________
NAME
Tk_HandleEvent - invoke event handlers for window system
eventsSYNOPSIS
#include
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_CreateEventHandler) that match
eventPtr and then returns. In some cases it may be useful for an application to bypass the Tk event queue and callTk_HandleEvent directly instead of calling Tcl_QueueEvent
followed by Tcl_ServiceEvent.
This procedure may be invoked recursively. For example, itis 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, windowATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes: Tk Last change: 1Tk Library Procedures Tk_HandleEvent(3TK)
_______________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE|
|____________________|__________________|_
| Availability | runtime/tk-8 |
|____________________|__________________|_
| Interface Stability| Uncommitted ||____________________|_________________|
NOTES Source for Tk is available on http://opensolaris.org. Tk Last change: 2