Client Library - Handlers API

---

Detailed Description

this api is used for setting and processing handlers, and callback for input events.

Example:

for further information look in demo/ directory

 void simpe_handle_onover (s_window_t *window, s_event_t *event, s_handler_t *handler)
 {
 }
 void simpe_handle_pressed (s_window_t *window, s_event_t *event, s_handler_t *handler)
 {
 }
 void simpe_handle_released (s_window_t *window, s_event_t *event, s_handler_t *handler)
 {
 }
 void simpe_handle_clicked (s_window_t *window, s_event_t *event, s_handler_t *handler)
 {
 }
 {
        s_handler_t *hndl;
        s_handler_init(&hndl);
        hndl->type = MOUSE_HANDLER;
        hndl->mouse.x = 0;
        hndl->mouse.y = 0;
        hndl->mouse.w = 20;
        hndl->mouse.h = 20;
        hndl->mouse.o = simpe_handle_onover;
        hndl->mouse.c = simpe_handle_clicked;
        hndl->mouse.p = simpe_handle_pressed;
        hndl->mouse.r = simpe_handle_released;
        hndl->mouse.button = MOUSE_LEFTBUTTON;
        s_handler_add(window, hndl);
 }

Data Structures
struct	s_handler_keybd_s
	keyboard handler struct More...
struct	s_handler_mouse_s
	mouse handler struct More...
struct	s_handler_s
	handler struct More...
struct	s_handlers_s
	handlers struct More...
Functions
int	s_handler_init (s_handler_t **handler)
	initialize the thandler struct.
int	s_handler_uninit (s_handler_t *handler)
	uninitialize the thandler struct.
int	s_handler_add (s_window_t *window, s_handler_t *handler)
	adds a handler to windows` handlers list
int	s_handler_del (s_window_t *window, s_handler_t *handler)
	deletes a handler from windows` handlers list
int	s_handlers_init (s_window_t *window)
	initialize the handlers struct for given window
int	s_handlers_uninit (s_window_t *window)
	uninitialize the handlers struct for given window

---

Function Documentation

int s_handler_add	(	s_window_t *	window,
		s_handler_t *	handler
	)

adds a handler to windows` handlers list

Parameters:

	*window	- window to attach the timer
	*handler	- the handler

Returns:

0 on success, 1 on error.

int s_handler_del	(	s_window_t *	window,
		s_handler_t *	handler
	)

deletes a handler from windows` handlers list

Parameters:

	*window	- window that holds the handler
	*handler	- handler

Returns:

0 on success, 1 on error.

int s_handler_init

(

s_handler_t **

handler

)

initialize the thandler struct.

Parameters:

**handler

- address of the handler pointer.

Returns:

0 on success, 1 on error.

int s_handler_uninit

(

s_handler_t *

handler

)

uninitialize the thandler struct.

Parameters:

*handler

- poniter to the handler, that was returned from s_handler_init.

Returns:

0 on success, 1 on error.

int s_handlers_init

(

s_window_t *

window

)

initialize the handlers struct for given window

Parameters:

*window

- window

Returns:

0 on success, 1 on error.

int s_handlers_uninit

(

s_window_t *

window

)

uninitialize the handlers struct for given window

Parameters:

*window

- window

Returns:

0 on success, 1 on error.

---