tickit_pen_bind_event - Man Page

add or remove event handlers

Synopsis

#include <tickit.h>

typedef int TickitPenEventFn(TickitPen *tt, TickitEventFlags flags,
    void *info, void *user);

int tickit_pen_bind_event(TickitPen *tt, TickitPenEvent ev,
    TickitBindFlags flags,
    TickitPenEventFn *fn, void *user);
void tickit_pen_unbind_event_id(TickitPen *tt, int id);

Link with -ltickit.

Description

tickit_pen_bind_event() adds a new event handler to the list of handlers stored by the pen, 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 pen 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_pen_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_pen_bind_event() returns an identifier integer. tickit_pen_unbind_event_id() returns no value.

See Also

tickit_pen_new(3), tickit_pen(7), tickit(7)

Referenced By

tickit_pen(7), tickit_pen_new(3).

The man page tickit_pen_unbind_event_id(3) is an alias of tickit_pen_bind_event(3).