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 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(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | KEYWORDS

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

home | help