TkCreateEventHandler(3) Tk Library Procedures TkCreateEventHandler(3)

NAME
       TkCreateEventHandler,   TkDeleteEventHandler  -  associate  procedure
       callback with an X event

SYNOPSIS
       ##iinncclluuddee <>

       TTkkCCrreeaatteeEEvveennttHHaannddlleerr(tkwin, mask, proc, clientData)

       TTkkDDeelleetteeEEvveennttHHaannddlleerr(tkwin, mask, proc, clientData)

AARRGGUUMMEENNTTSS
       TkWindow       tkwin        (in)      Token for window in which events
                                              may occur.

       unsigned long   mask         (in)      Bit-mask of events (such as BBuutt-
                                              ttoonnPPrreessssMMaasskk)  for  which   proc
                                              should be called.

       TkEventProc    *proc        (in)      Procedure  to invoke whenever an
                                              event in mask occurs in the win-
                                              dow given by tkwin.

       ClientData      clientData   (in)      Arbitrary one-word value to pass
                                              to proc.



DESCRIPTION
       TTkkCCrreeaatteeEEvveennttHHaannddlleerr arranges for proc to be  invoked  in  the  future
       whenever  one of the event types specified by mask occurs in the window
       specified by tkwin.  The callback to  proc  will  be  made  by  TTkkHHaann-
       ddlleeEEvveenntt;  this  mechanism  only works in programs that dispatch events
       through TTkkHHaannddlleeEEvveenntt  (or  through  other  Tk  procedures  that  call
       TTkkHHaannddlleeEEvveenntt, such as TTkkDDooOOnneeEEvveenntt or TTkkMMaaiinnLLoooopp).

       Proc should have arguments and result that match the type TTkkEEvveennttPPrroocc:
              typedef void TkEventProc(
                ClientData clientData,
                XEvent *eventPtr);
       The clientData parameter to proc is a copy of the  clientData  argument
       given  to  TTkkCCrreeaatteeEEvveennttHHaannddlleerr  when the callback was created.  Typi-
       cally, clientData points to a data  structure  containing  application-
       specific  information  about  the  window  in which the event occurred.
       EventPtr is a pointer to the X event, which will be  one  of  the  ones
       specified in the mask argument to TTkkCCrreeaatteeEEvveennttHHaannddlleerr.

       TTkkDDeelleetteeEEvveennttHHaannddlleerr  may  be  called  to  delete a previously-created
       event handler:  it deletes the first handler it finds that  is  associ-
       ated  with  tkwin and matches the mask, proc, and clientData arguments.
       If no such handler exists, then TTkkHHaannddlleeEEvveenntt  returns  without  doing
       anything.   Although  Tk  supports it, it's probably a bad idea to have
       more than one callback with the same mask, proc, and  clientData  argu-
       ments.   When  a  window is deleted all of its handlers will be deleted
       automatically;  in this case there is no need  to  call  TTkkDDeelleetteeEEvveenn-
       ttHHaannddlleerr.

       If  multiple  handlers are declared for the same type of X event on the
       same window, then the handlers will be invoked in the order  they  were
       created.


KKEEYYWWOORRDDSS
       bind, callback, event, handler



Tk                                                    TkCreateEventHandler(3)