NAME

       tickit_term_bind_event, tickit_term_unbind_event_id - add or remove event handlers

SYNOPSIS

       #include <tickit.h>

       typedef int TickitTermEventFn(TickitTerm *tt, TickitEventFlags flags,
           void *info, void *user);

       int tickit_term_bind_event(TickitTerm *tt, TickitTermEvent ev,
           TickitBindFlags flags,
           TickitTermEventFn *fn, void *user);
       void tickit_term_unbind_event_id(TickitTerm *tt, int id);

       Link with -ltickit.

DESCRIPTION

       tickit_term_bind_event()  adds  a  new event handler to the list of handlers stored by the
       terminal, and returns an integer to identify this handler. This handler  will  be  invoked
       for  occurrences  of the event given by the ev argument. When invoked, func will be passed
       the terminal 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_term_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_term_bind_event()  returns  an  identifier  integer.  tickit_term_unbind_event_id()
       returns no value.

SEE ALSO

       tickit_term_build(3), tickit_term(7), tickit(7)

                                                                        TICKIT_TERM_BIND_EVENT(3)