Input Events Feeding Functions

Functions to tell Evas that input events happened and should be processed. More...

Functions
Evas_Device *	evas_device_new (Evas *e)
void	evas_device_free (Evas_Device *dev)
void	evas_device_push (Evas *e, Evas_Device *dev)
void	evas_device_pop (Evas *e)
const Eina_List *	evas_device_list (Evas *e, const Evas_Device *dev)
void	evas_device_name_set (Evas_Device *dev, const char *name)
const char *	evas_device_name_get (const Evas_Device *dev)
void	evas_device_description_set (Evas_Device *dev, const char *desc)
const char *	evas_device_description_get (const Evas_Device *dev)
void	evas_device_parent_set (Evas_Device *dev, Evas_Device *parent)
const Evas_Device *	evas_device_parent_get (const Evas_Device *dev)
void	evas_device_class_set (Evas_Device *dev, Evas_Device_Class clas)
Evas_Device_Class	evas_device_class_get (const Evas_Device *dev)
void	evas_device_emulation_source_set (Evas_Device *dev, Evas_Device *src)
const Evas_Device *	evas_device_emulation_source_get (const Evas_Device *dev)
int	evas_event_down_count_get (const Evas *e)
	Get the number of mouse or multi presses currently active.
void	evas_event_feed_mouse_down (Evas *e, int b, Evas_Button_Flags flags, unsigned int timestamp, const void *data)
	Mouse down event feed.
void	evas_event_feed_mouse_up (Evas *e, int b, Evas_Button_Flags flags, unsigned int timestamp, const void *data)
	Mouse up event feed.
void	evas_event_feed_mouse_move (Evas *e, int x, int y, unsigned int timestamp, const void *data)
	Mouse move event feed.
void	evas_event_feed_mouse_in (Evas *e, unsigned int timestamp, const void *data)
	Mouse in event feed.
void	evas_event_feed_mouse_out (Evas *e, unsigned int timestamp, const void *data)
	Mouse out event feed.
void	evas_event_feed_multi_down (Evas *e, int d, int x, int y, double rad, double radx, double rady, double pres, double ang, double fx, double fy, Evas_Button_Flags flags, unsigned int timestamp, const void *data)
void	evas_event_feed_multi_up (Evas *e, int d, int x, int y, double rad, double radx, double rady, double pres, double ang, double fx, double fy, Evas_Button_Flags flags, unsigned int timestamp, const void *data)
void	evas_event_feed_multi_move (Evas *e, int d, int x, int y, double rad, double radx, double rady, double pres, double ang, double fx, double fy, unsigned int timestamp, const void *data)
void	evas_event_feed_mouse_cancel (Evas *e, unsigned int timestamp, const void *data)
	Mouse cancel event feed.
void	evas_event_feed_mouse_wheel (Evas *e, int direction, int z, unsigned int timestamp, const void *data)
	Mouse wheel event feed.
void	evas_event_feed_key_down (Evas *e, const char *keyname, const char *key, const char *string, const char *compose, unsigned int timestamp, const void *data)
	Key down event feed.
void	evas_event_feed_key_up (Evas *e, const char *keyname, const char *key, const char *string, const char *compose, unsigned int timestamp, const void *data)
	Key up event feed.
void	evas_event_feed_hold (Evas *e, int hold, unsigned int timestamp, const void *data)
	Hold event feed.
void	evas_event_refeed_event (Evas *e, void *event_copy, Evas_Callback_Type event_type)
	Re feed event.

Detailed Description

Functions to tell Evas that input events happened and should be processed.

Warning

Most of the time these functions are not what you're looking for. These functions should only be used if you're not working with ecore evas(or another input handling system). If you're not using ecore evas please consider using it, in most situation it will make life a lot easier.

As explained in intro_not_evas, Evas does not know how to poll for input events, so the developer should do it and then feed such events to the canvas to be processed. This is only required if operating Evas directly. Modules such as Ecore_Evas do that for you.

Some of the functions in this group are exemplified here.

Function Documentation

Evas_Device* evas_device_new

(

Evas *

e

)

Since

1.8

References eina_list_append(), eo_data_get(), and EVAS_CALLBACK_DEVICE_CHANGED.

void evas_device_free

(

Evas_Device *

dev

)

Since

1.8

References EINA_LIST_FREE, and evas_device_free().

Referenced by evas_device_free().

void evas_device_push	(	Evas *	e,
		Evas_Device *	dev
	)

Since

1.8

References eina_array_new(), and eo_data_get().

void evas_device_pop

(

Evas *

e

)

Since

1.8

References eo_data_get().

const Eina_List* evas_device_list	(	Evas *	e,
		const Evas_Device *	dev
	)

Since

1.8

References eo_data_get().

void evas_device_name_set	(	Evas_Device *	dev,
		const char *	name
	)

Since

1.8

References eina_stringshare_replace(), and EVAS_CALLBACK_DEVICE_CHANGED.

const char* evas_device_name_get

(

const Evas_Device *

dev

)

Since

1.8

void evas_device_description_set	(	Evas_Device *	dev,
		const char *	desc
	)

Since

1.8

References eina_stringshare_replace(), and EVAS_CALLBACK_DEVICE_CHANGED.

const char* evas_device_description_get

(

const Evas_Device *

dev

)

Since

1.8

void evas_device_parent_set	(	Evas_Device *	dev,
		Evas_Device *	parent
	)

Since

1.8

References eina_list_append(), eina_list_remove(), and EVAS_CALLBACK_DEVICE_CHANGED.

const Evas_Device* evas_device_parent_get

(

const Evas_Device *

dev

)

Since

1.8

void evas_device_class_set	(	Evas_Device *	dev,
		Evas_Device_Class	clas
	)

Since

1.8

References EVAS_CALLBACK_DEVICE_CHANGED.

Evas_Device_Class evas_device_class_get

(

const Evas_Device *

dev

)

Since

1.8

References EVAS_DEVICE_CLASS_NONE.

void evas_device_emulation_source_set	(	Evas_Device *	dev,
		Evas_Device *	src
	)

Since

1.8

References EVAS_CALLBACK_DEVICE_CHANGED.

const Evas_Device* evas_device_emulation_source_get

(

const Evas_Device *

dev

)

Since

1.8

int evas_event_down_count_get

(

const Evas *

e

)

Get the number of mouse or multi presses currently active.

e The given canvas pointer.

Returns

The numer of presses (0 if none active).

Since

1.2

References eo_do, and evas_canvas_event_down_count_get.

void evas_event_feed_mouse_down	(	Evas *	e,
		int	b,
		Evas_Button_Flags	flags,
		unsigned int	timestamp,
		const void *	data
	)

Mouse down event feed.

Parameters

e	The given canvas pointer.
b	The button number.
flags	The evas button flags.
timestamp	The timestamp of the mouse down event.
data	The data for canvas.

This function will set some evas properties that is necessary when the mouse button is pressed. It prepares information to be treated by the callback function.

References eo_do, and evas_canvas_event_feed_mouse_down.

void evas_event_feed_mouse_up	(	Evas *	e,
		int	b,
		Evas_Button_Flags	flags,
		unsigned int	timestamp,
		const void *	data
	)

Mouse up event feed.

Parameters

e	The given canvas pointer.
b	The button number.
flags	evas button flags.
timestamp	The timestamp of the mouse up event.
data	The data for canvas.

This function will set some evas properties that is necessary when the mouse button is released. It prepares information to be treated by the callback function.

References eo_do, and evas_canvas_event_feed_mouse_up.

void evas_event_feed_mouse_move	(	Evas *	e,
		int	x,
		int	y,
		unsigned int	timestamp,
		const void *	data
	)

Mouse move event feed.

Parameters

e	The given canvas pointer.
x	The horizontal position of the mouse pointer.
y	The vertical position of the mouse pointer.
timestamp	The timestamp of the mouse up event.
data	The data for canvas.

This function will set some evas properties that is necessary when the mouse is moved from its last position. It prepares information to be treated by the callback function.

References eo_do, and evas_canvas_event_feed_mouse_move.

void evas_event_feed_mouse_in	(	Evas *	e,
		unsigned int	timestamp,
		const void *	data
	)

Mouse in event feed.

Parameters

e	The given canvas pointer.
timestamp	The timestamp of the mouse up event.
data	The data for canvas.

This function will set some evas properties that is necessary when the mouse in event happens. It prepares information to be treated by the callback function.

References eo_do, and evas_canvas_event_feed_mouse_in.

void evas_event_feed_mouse_out	(	Evas *	e,
		unsigned int	timestamp,
		const void *	data
	)

Mouse out event feed.

Parameters

e	The given canvas pointer.
timestamp	Timestamp of the mouse up event.
data	The data for canvas.

This function will set some evas properties that is necessary when the mouse out event happens. It prepares information to be treated by the callback function.

References eo_do, and evas_canvas_event_feed_mouse_out.

void evas_event_feed_mouse_cancel	(	Evas *	e,
		unsigned int	timestamp,
		const void *	data
	)

Mouse cancel event feed.

Parameters

e	The given canvas pointer.
timestamp	The timestamp of the mouse up event.
data	The data for canvas.

This function will call evas_event_feed_mouse_up() when a mouse cancel event happens.

References eo_do, and evas_canvas_event_feed_mouse_cancel.

void evas_event_feed_mouse_wheel	(	Evas *	e,
		int	direction,
		int	z,
		unsigned int	timestamp,
		const void *	data
	)

Mouse wheel event feed.

Parameters

e	The given canvas pointer.
direction	The wheel mouse direction.
z	How much mouse wheel was scrolled up or down.
timestamp	The timestamp of the mouse up event.
data	The data for canvas.

This function will set some evas properties that is necessary when the mouse wheel is scrolled up or down. It prepares information to be treated by the callback function.

References eo_do, and evas_canvas_event_feed_mouse_wheel.

void evas_event_feed_key_down	(	Evas *	e,
		const char *	keyname,
		const char *	key,
		const char *	string,
		const char *	compose,
		unsigned int	timestamp,
		const void *	data
	)

Key down event feed.

Parameters

e	The canvas to thaw out
keyname	Name of the key
key	The key pressed.
string	A String
compose	The compose string
timestamp	Timestamp of the mouse up event
data	Data for canvas.

This function will set some evas properties that is necessary when a key is pressed. It prepares information to be treated by the callback function.

References eo_do, and evas_canvas_event_feed_key_down.

void evas_event_feed_key_up	(	Evas *	e,
		const char *	keyname,
		const char *	key,
		const char *	string,
		const char *	compose,
		unsigned int	timestamp,
		const void *	data
	)

Key up event feed.

Parameters

e	The canvas to thaw out
keyname	Name of the key
key	The key released.
string	string
compose	compose
timestamp	Timestamp of the mouse up event
data	Data for canvas.

This function will set some evas properties that is necessary when a key is released. It prepares information to be treated by the callback function.

References eo_do, and evas_canvas_event_feed_key_up.

void evas_event_feed_hold	(	Evas *	e,
		int	hold,
		unsigned int	timestamp,
		const void *	data
	)

Hold event feed.

Parameters

e	The given canvas pointer.
hold	The hold.
timestamp	The timestamp of the mouse up event.
data	The data for canvas.

This function makes the object to stop sending events.

References eo_do, and evas_canvas_event_feed_hold.

void evas_event_refeed_event	(	Evas *	e,
		void *	event_copy,
		Evas_Callback_Type	event_type
	)

Re feed event.

Parameters

e	The given canvas pointer.
event_copy	the event to refeed
event_type	Event type

This function re-feeds the event pointed by event_copy

This function call evas_event_feed_* functions, so it can cause havoc if not used wisely. Please use it responsibly.

References eo_do, and evas_canvas_event_refeed_event.