Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Tk_HandleEvent(3)	      Tk Library Procedures	       Tk_HandleEvent(3)

________________________________________________________________________________

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 relevant
				    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 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
     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, window

Tk							       Tk_HandleEvent(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_HandleEvent.tk86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help