Ecore_Evas Single Process Windowing System.

---

These are global scope functions to manage the EWS to be used by ecore_evas_ews_new().

Since (EFL) :

1.1

Functions
Eina_Bool	ecore_evas_ews_engine_set (const char *engine, const char *options)
	Sets the engine to be used by the backing store engine.
Eina_Bool	ecore_evas_ews_setup (int x, int y, int w, int h)
	Reconfigures the backing store used.
Ecore_Evas *	ecore_evas_ews_ecore_evas_get (void)
	Returns the internal backing store in use.
Evas *	ecore_evas_ews_evas_get (void)
	Returns the internal backing store in use.
Evas_Object *	ecore_evas_ews_background_get (void)
	Gets the current background.
void	ecore_evas_ews_background_set (Evas_Object *o)
	Sets the current background, must be created by evas ecore_evas_ews_evas_get().
const Eina_List *	ecore_evas_ews_children_get (void)
	Returns all Ecore_Evas* created by EWS.
void	ecore_evas_ews_manager_set (const void *manager)
	Sets the identifier of the manager taking care of internal windows.
const void *	ecore_evas_ews_manager_get (void)
	Gets the identifier of the manager taking care of internal windows.

---

Function Documentation

void ecore_evas_ews_background_set

(

Evas_Object *

o

)

Sets the current background, must be created by evas ecore_evas_ews_evas_get().

Parameters:

o	The Evas_Object for which to set the background.

It will be kept at lowest layer (EVAS_LAYER_MIN) and below everything else. You can set any object, default is a black rectangle.

Note:

previous object will be deleted!

const Eina_List* ecore_evas_ews_children_get

(

void

)

Returns all Ecore_Evas* created by EWS.

Returns:

An eina list of Ecore_evases.

Note:

Do not change the returned list or its contents.

Since (EFL) :

1.1

Ecore_Evas* ecore_evas_ews_ecore_evas_get

(

void

)

Returns the internal backing store in use.

Returns:

The internal backing store in use.

Note:

this will force it to be created, making future calls to ecore_evas_ews_engine_set() void.

See also:

ecore_evas_ews_evas_get()

Since (EFL) :

1.1

Eina_Bool ecore_evas_ews_engine_set	(	const char *	engine,
		const char *	options
	)

Sets the engine to be used by the backing store engine.

Parameters:

engine	The engine to be set.
options	The options of the engine to be set.

Returns:

EINA_TRUE on success, EINA_FALSE if ews is already in use.

Since (EFL) :

1.1

Evas* ecore_evas_ews_evas_get

(

void

)

Returns the internal backing store in use.

Returns:

The internal backing store in use.

Note:

this will force it to be created, making future calls to ecore_evas_ews_engine_set() void.

See also:

ecore_evas_ews_ecore_evas_get()

Since (EFL) :

1.1

const void* ecore_evas_ews_manager_get

(

void

)

Gets the identifier of the manager taking care of internal windows.

Returns:

the value set by ecore_evas_ews_manager_set()

Since (EFL) :

1.1

void ecore_evas_ews_manager_set

(

const void *

manager

)

Sets the identifier of the manager taking care of internal windows.

Parameters:

manager

any unique identifier address.

The ECORE_EVAS_EWS_EVENT_MANAGER_CHANGE event is issued. Consider handling it to know if you should stop handling events yourself (ie: another manager took over)

See also:

ecore_evas_ews_manager_get()

Since (EFL) :

1.1

Eina_Bool ecore_evas_ews_setup	(	int	x,
		int	y,
		int	w,
		int	h
	)

Reconfigures the backing store used.

Parameters:

x	The X coordinate to be used.
y	The Y coordinate to be used.
w	The width of the Ecore_Evas to setup.
h	The height of the Ecore_Evas to setup.

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

Since (EFL) :

1.1

---

Variable Documentation

int ECORE_EVAS_EWS_EVENT_ACTIVATE

window was activated

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_ADD

window was created

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_CONFIG_CHANGE

some other window property changed (title, name, class, alpha, transparent, shaped...)

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_DEL

window was deleted, pointer is already invalid but may be used as reference for further cleanup work.

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_FOCUS

window was focused

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_FULLSCREEN_CHANGE

window fullscreen changed

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_HIDE

window become hidden

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_ICONIFIED_CHANGE

window minimized/iconified changed

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_LAYER_CHANGE

window layer changed

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_LOWER

window was lowered

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_MANAGER_CHANGE

manager was changed

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_MAXIMIZED_CHANGE

window maximized changed

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_MOVE

window was moved

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_RAISE

window was raised

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_RESIZE

window was resized

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_SHOW

window become visible

Since (EFL) :

1.1

int ECORE_EVAS_EWS_EVENT_UNFOCUS

window lost focus

Since (EFL) :

1.1