1Tk_HandleEvent(3)            Tk Library Procedures           Tk_HandleEvent(3)
2
3
4
5______________________________________________________________________________
6

NAME

8       Tk_HandleEvent - invoke event handlers for window system events
9

SYNOPSIS

11       #include <tk.h>
12
13       Tk_HandleEvent(eventPtr)
14

ARGUMENTS

16       XEvent *eventPtr (in)          Pointer  to X event to dispatch to rele‐
17                                      vant handler(s). It  is  important  that
18                                      all  unused  fields  of the structure be
19                                      set to zero.
20______________________________________________________________________________
21

DESCRIPTION

23       Tk_HandleEvent is  a  lower-level  procedure  that  deals  with  window
24       events.    It   is   called  by  Tcl_ServiceEvent  (and  indirectly  by
25       Tcl_DoOneEvent), and in a few other cases within Tk.   It  makes  call‐
26       backs  to any window event handlers (created by calls to Tk_CreateEven‐
27       tHandler) that match eventPtr and then returns.  In some cases  it  may
28       be  useful  for  an  application  to bypass the Tk event queue and call
29       Tk_HandleEvent directly instead of calling Tcl_QueueEvent  followed  by
30       Tcl_ServiceEvent.
31
32       This procedure may be invoked recursively.  For example, it is possible
33       to invoke Tk_HandleEvent recursively from a handler called  by  Tk_Han‐
34       dleEvent.   This  sort of operation is useful in some modal situations,
35       such as when a notifier has been popped up and an application wishes to
36       wait  for  the user to click a button in the notifier before doing any‐
37       thing else.
38

KEYWORDS

40       callback, event, handler, window
41
42
43
44Tk                                                           Tk_HandleEvent(3)
Impressum