NAME

       tickit_window_bind_event, tickit_window_unbind_event_id - add or remove event handlers

SYNOPSIS

       #include <tickit.h>

       typedef int TickitWindowEventFn(TickitWindow *win, TickitEventFlags flags,
           void *info, void *user);

       int tickit_window_bind_event(TickitWindow *win, TickitWindowEvent ev,
           TickitBindFlags flags,
           TickitWindowEventFn *fn, void *user);
       void tickit_window_unbind_event_id(TickitWindow *win, int id);

       Link with -ltickit.

DESCRIPTION

       tickit_window_bind_event()  adds  a  new  event handler to the list of handlers stored by the window, and
       returns an integer to identify this handler. This handler will be invoked for  occurances  of  the  event
       given  by  the  ev  argument.  When  invoked, func will be passed the window instance, a flags bitmask, a
       pointer to an event information structure whose type depends on the event, and the user data  pointer  it
       was installed with.

       tickit_window_unbind_event_id()  removes  an  event  handler previously added, by the identifier returned
       when  it  was  added,  invoking  it  with  the  TICKIT_EV_UNBIND  flag   if   it   was   installed   with
       TICKIT_BIND_UNBIND.

RETURN VALUE

       tickit_window_bind_event()  returns  an  identifier  integer.  tickit_window_unbind_event_id() returns no
       value.

SEE ALSO

       tickit_window_new(3), tickit_window_flush(3), tickit_window(7), tickit(7)

                                                                                     TICKIT_WINDOW_BIND_EVENT(3)