Functions
int	efl_util_set_notification_window_level (Evas_Object *window, efl_util_notification_level_e level)
	Sets the priority level for the specified notification window, asynchronously.
int	efl_util_get_notification_window_level (Evas_Object window, efl_util_notification_level_e level)
	Gets the priority level for the specified notification window, asynchronously.
int	efl_util_set_notification_window_level_error_cb (Evas_Object window, efl_util_notification_window_level_error_cb callback, void user_data)
	Registers a callback function to be invoked when an error which set the notification level occurs.
int	efl_util_unset_notification_window_level_error_cb (Evas_Object *window)
	Unregisters the callback function.
int	efl_util_set_window_opaque_state (Evas_Object *window, int opaque)
	Sets the alpha window's visual state to opaque state.
int	efl_util_set_window_screen_mode (Evas_Object *window, efl_util_screen_mode_e mode)
	Sets the window's screen mode.
int	efl_util_get_window_screen_mode (Evas_Object window, efl_util_screen_mode_e mode)
	Gets the screen mode of the specified window.
int	efl_util_set_window_screen_mode_error_cb (Evas_Object window, efl_util_window_screen_mode_error_cb callback, void user_data)
	Registers a callback function to be invoked when an error which set the screen mode.
int	efl_util_unset_window_screen_mode_error_cb (Evas_Object *window)
	Unregisters the callback function.
Typedefs
typedef void(*	efl_util_notification_window_level_error_cb )(Evas_Object window, int error_code, void user_data)
	Called when an error occurs for setting notification window level.
typedef void(*	efl_util_window_screen_mode_error_cb )(Evas_Object window, int error_code, void user_data)
	Called when an error occurs for setting window's screen mode.

Required Header

#include <efl_util.h>

Overview

The EFL UTIL API provides functions to get the level of given notification windows and to change the notification window levels with the given values.

The notification window level is used in ordering the notification windows. The notification window which is set to EFL_UTIL_NOTIFICATION_LEVEL_2 will be placed above the window which is set to EFL_UTIL_NOTIFICATION_LEVEL_1. If there are notification windows that have the same levels, the latest created notification window is placed on top of the other window.

Typedef Documentation

typedef void(* efl_util_notification_window_level_error_cb)(Evas_Object *window, int error_code, void *user_data)

Called when an error occurs for setting notification window level.

Since :: 2.3

Parameters:

[in]	window	The EFL window
[in]	error_code	The error code (EFL_UTIL_ERROR_PERMISSION_DENIED)
[in]	user_data	The user data passed from the callback registration function

See also:: efl_util_set_notification_window_level_error_cb(); efl_util_unset_notification_window_level_error_cb()

typedef void(* efl_util_window_screen_mode_error_cb)(Evas_Object *window, int error_code, void *user_data)

Called when an error occurs for setting window's screen mode.

Since :: 2.4

Parameters:

[in]	window	The EFL window
[in]	error_code	The error code (EFL_UTIL_ERROR_PERMISSION_DENIED)
[in]	user_data	The user data passed from the callback registration function

See also:: efl_util_set_window_screen_mode_error_cb(); efl_util_unset_window_screen_mode_error_cb()

Enumeration Type Documentation

enum efl_util_error_e

Enumeration for EFL UTIL ERROR.

Since :: 2.3

Enumerator:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORY	Out of memory
EFL_UTIL_ERROR_PERMISSION_DENIED	Permisson denied
EFL_UTIL_ERROR_NO_SUCH_DEVICE	Warning: This is not for use by third-party applications. No such device or address (Since: 2.4)
EFL_UTIL_ERROR_INVALID_OPERATION	Warning: This is not for use by third-party applications. Function not implemented (Since: 2.4)
EFL_UTIL_ERROR_NOT_SUPPORTED	Warning: This is not for use by third-party applications. Not supported (Since: 2.4)
EFL_UTIL_ERROR_NOT_SUPPORTED_WINDOW_TYPE	Window type not supported
EFL_UTIL_ERROR_SCREENSHOT_INIT_FAIL	Warning: This is not for use by third-party applications. Screenshot initialization fail (Since: 2.4)
EFL_UTIL_ERROR_SCREENSHOT_EXECUTION_FAIL	Warning: This is not for use by third-party applications. Screenshot execution fail (Since: 2.4)

enum efl_util_notification_level_e

Enumeration of notification window's priority level.

Since :: 2.3

Enumerator:

EFL_UTIL_NOTIFICATION_LEVEL_1	Default notification level. (Deprecated since 2.4. Use EFL_UTIL_NOTIFICATION_LEVEL_DEFAULT instead.)
EFL_UTIL_NOTIFICATION_LEVEL_2	Higher notification level than default. (Deprecated since 2.4. Use EFL_UTIL_NOTIFICATION_LEVEL_MEDIUM instead.)
EFL_UTIL_NOTIFICATION_LEVEL_3	The highest notification level. (Deprecated since 2.4. Use EFL_UTIL_NOTIFICATION_LEVEL_TOP instead.)
EFL_UTIL_NOTIFICATION_LEVEL_NONE	No (reset) notification level. This value makes the window place in normal layer. (Since: 2.4)
EFL_UTIL_NOTIFICATION_LEVEL_DEFAULT	Default notification level. (Since: 2.4)
EFL_UTIL_NOTIFICATION_LEVEL_MEDIUM	Higher notification level than default. (Since: 2.4)
EFL_UTIL_NOTIFICATION_LEVEL_HIGH	Higher notification level than medium. (Since: 2.4)
EFL_UTIL_NOTIFICATION_LEVEL_TOP	The highest notification level. (Since: 2.4)

enum efl_util_screen_mode_e

Enumeration of screen mode.

Since :: 2.4

Enumerator:

EFL_UTIL_SCREEN_MODE_DEFAULT	The mode which turns the screen off after a timeout.
EFL_UTIL_SCREEN_MODE_ALWAYS_ON	The mode which keeps the screen turned on.

Function Documentation

int efl_util_get_notification_window_level	(	Evas_Object *	window,
		efl_util_notification_level_e *	level
	)

Gets the priority level for the specified notification window, asynchronously.

Since :: 2.3

Remarks:: This API can be used for a notification type window only.

Parameters:

[in]	window	The EFL window
[out]	level	The notification window level

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NOT_SUPPORTED_WINDOW_TYPE	Window type not supported

int efl_util_get_window_screen_mode	(	Evas_Object *	window,
		efl_util_screen_mode_e *	mode
	)

Gets the screen mode of the specified window.

Since :: 2.4

Parameters:

[in]	window	The EFL window
[out]	mode	The screen mode

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter

int efl_util_set_notification_window_level	(	Evas_Object *	window,
		efl_util_notification_level_e	level
	)

Sets the priority level for the specified notification window, asynchronously.

Since :: 2.3

Privilege Level:: public

Privilege:: http://tizen.org/privilege/window.priority.set

Remarks:: This API can be used for a notification type window only.

Parameters:

[in]	window	The EFL window
[in]	level	The notification window level

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NOT_SUPPORTED_WINDOW_TYPE	Window type not supported

int efl_util_set_notification_window_level_error_cb	(	Evas_Object *	window,
		efl_util_notification_window_level_error_cb	callback,
		void *	user_data
	)

Registers a callback function to be invoked when an error which set the notification level occurs.

Since :: 2.3

Parameters:

[in]	window	The EFL window
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORY	Out of memory

Postcondition:: efl_util_notification_window_level_error_cb() will be invoked.

See also:: efl_util_unset_notification_window_level_error_cb(); efl_util_notification_window_level_error_cb()

int efl_util_set_window_opaque_state	(	Evas_Object *	window,
		int	opaque
	)

Sets the alpha window's visual state to opaque state.

This API sets the alpha window's visual state to opaque state. If the alpha window sets the visual state to the opaque, then the window manager could handle it as the opaque window while calculating visibility. This API will have no effect when used by a non-alpha window.

Since :: 2.4

Parameters:

[in]	window	The EFL window
[in]	opaque	The value that indicates whether the window has set a visual state to opaque (0: unset, 1: set)

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter

int efl_util_set_window_screen_mode	(	Evas_Object *	window,
		efl_util_screen_mode_e	mode
	)

Sets the window's screen mode.

This API is useful when the application need to keep the display turned on. If the application set the mode to EFL_UTIL_SCREEN_MODE_ALWAYS_ON to its window and the window is shown wholly or partially, the window manager requests the display system to keep the display on as long as the window is shown. If the window is no longer shown, then the window manger request the display system to go back to normal operation. Default screen mode of window is EFL_UTIL_SCREEN_MODE_DEFAULT.

Since :: 2.4

Privilege Level:: public

Privilege:: http://tizen.org/privilege/display

Remarks:: This API needs the privilege. If the application which is not get the privilege use this API, the window manager generates the permission deny error. The application can notice this error if it set the callback function using the efl_util_set_window_screen_mode_error_cb().

Parameters:

[in]	window	The EFL window
[in]	mode	The screen mode

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter

int efl_util_set_window_screen_mode_error_cb	(	Evas_Object *	window,
		efl_util_window_screen_mode_error_cb	callback,
		void *	user_data
	)

Registers a callback function to be invoked when an error which set the screen mode.

Since :: 2.4

Parameters:

[in]	window	The EFL window
[in]	callback	The callback function to register
[in]	user_data	The user data to be passed to the callback function

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORY	Out of memory

Postcondition:: efl_util_window_screen_mode_error_cb() will be invoked.

See also:: efl_util_unset_window_screen_mode_error_cb(); efl_util_window_screen_mode_error_cb()

int efl_util_unset_notification_window_level_error_cb ( Evas_Object * window )

Unregisters the callback function.

Since :: 2.3

Parameters:

[in] window The EFL window

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: efl_util_set_notification_window_level_error_cb()

int efl_util_unset_window_screen_mode_error_cb ( Evas_Object * window )

Unregisters the callback function.

Since :: 2.4

Parameters:

[in] window The EFL window

Returns:: 0 on success, otherwise a negative error value

Return values:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter

See also:: efl_util_set_window_screen_mode_error_cb()

Functions

Typedefs

Required Header

Overview

Typedef Documentation

Enumeration Type Documentation

Function Documentation