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)