Handling global gesture events.

Required Header

#include <efl_util.h>

Overview

The EFL UTIL API provides functions to grab / select / activate global gestures and propagate these events to server modules or applications.

Grabbing Gestures

To receive global gesture events, you must grab the gestures that you want. You can grab gestures in the background (without a window). Each gesture can only be grabbed by 1 client at a time. For example, if a client grabs a 2-finger double tap gesture, other clients cannot grab the same gesture but can grab a 2-finger triple tap gesture. You can grab edge swipe, edge drag, tap, and palm cover gestures.

To grab gestures, follow these steps: 1. Create callbacks for gesture events.
2. Create the efl_util_gesture_h structure and initialize the structure members with the efl_util_gesture_initialize() function.
3. Define the gesture data to grab using the efl_util_gesture_xxx_new() and efl_util_gesture_xxx_size_set() functions.
Setting a size is optional. If a size is not set, the gesture is grabbed within a full-size edge.
4. To grab a gesture, use the efl_util_gesture_grab() function.
5. Define the gesture event handlers.
6. Run the main loop.
7. When no longer needed, free the resources and deinitialize the efl_util_gesture_h structure.

Selecting Gestures

Unlike grabbing, selecting a gesture requires a window. By selecting a gesture, you can detect gesture events when the selected window is active. Selecting has a higher priority than grabbing. Only the palm cover gesture can be selected.

To select a gesture, follow these steps: 1. Create the required callbacks: a callback for the gesture event and a callback for window destruction
2. Create the efl_util_gesture_h structure and initialize the structure members with the efl_util_gesture_initialize() function.
3. Define the gesture data to select.
4. Create and show a window in which you want to select a gesture.
5. To select the gesture, use the efl_util_gesture_select() function.
6. Define the gesture event handler.
7. Run the main loop.
8. When no longer needed, free the resources and deinitialize the efl_util_gesture_h structure.

Deactivating Gestures

Gestures are activated by default.

To deactivate and re-activate gestures, follow these steps: 1. Create the efl_util_gesture_h structure and initialize the structure members with the efl_util_gesture_initialize() function.
2. To deactivate a gesture type, use the efl_util_gesture_activate_set() function.
3. Run the main loop.
4. When no longer needed, re-activate the gestures and deinitialize the efl_util_gesture_h structure.

Deactivating Gestures in a Window

Gestures are activated by default.

To deactivate and re-activate gestures in a window, follow these steps: 1. Create the window destruction callback.
2. Create the efl_util_gesture_h structure and initialize the structure members with the efl_util_gesture_initialize() function.
3. Create and show a window in which you want to deactivate a gesture.
4. To deactivate a gesture type, use the efl_util_gesture_activate_set_on_window() function.
5. Run the main loop.
6. When no longer needed, re-activate the gestures, delete the window, and deinitialize the efl_util_gesture_h structure.

Functions
efl_util_gesture_h	efl_util_gesture_initialize (void)
	Initializes system and check if global gestures are supported.
int	efl_util_gesture_deinitialize (efl_util_gesture_h gesture_h)
	Deinitializes system.
efl_util_gesture_data	efl_util_gesture_edge_swipe_new (efl_util_gesture_h gesture_h, unsigned int fingers, efl_util_gesture_edge_e edge)
	Generates a edge swipe gesture's grab info handle.
int	efl_util_gesture_edge_swipe_free (efl_util_gesture_h gesture_h, efl_util_gesture_data data)
	Frees a memory of edge swipe gesture's grab info handle.
int	efl_util_gesture_edge_swipe_size_set (efl_util_gesture_data data, efl_util_gesture_edge_size_e edge_size, unsigned int start_point, unsigned int end_point)
	Sets a specific size of edge for edge swipe gesture.
efl_util_gesture_data	efl_util_gesture_edge_drag_new (efl_util_gesture_h gesture_h, unsigned int fingers, efl_util_gesture_edge_e edge)
	Generates a edge drag gesture's grab info handle.
int	efl_util_gesture_edge_drag_free (efl_util_gesture_h gesture_h, efl_util_gesture_data data)
	Frees a memory of edge drag gesture's grab info handle.
int	efl_util_gesture_edge_drag_size_set (efl_util_gesture_data data, efl_util_gesture_edge_size_e edge_size, unsigned int start_point, unsigned int end_point)
	Sets a specific size of edge for edge drag gesture.
efl_util_gesture_data	efl_util_gesture_tap_new (efl_util_gesture_h gesture_h, unsigned int fingers, unsigned int repeats)
	Generates a tap gesture's grab info handle.
int	efl_util_gesture_tap_free (efl_util_gesture_h gesture_h, efl_util_gesture_data data)
	Frees a memory of tap gesture's grab info handle.
efl_util_gesture_data	efl_util_gesture_palm_cover_new (efl_util_gesture_h gesture_h)
	Generates a palm cover gesture's grab info handle.
int	efl_util_gesture_palm_cover_free (efl_util_gesture_h gesture_h, efl_util_gesture_data data)
	Frees a memory of palm cover gesture's grab info handle.
int	efl_util_gesture_grab (efl_util_gesture_h gesture_h, efl_util_gesture_data data)
	Grabs a global gesture.
int	efl_util_gesture_ungrab (efl_util_gesture_h gesture_h, efl_util_gesture_data data)
	Ungrabs a global gesture.
int	efl_util_gesture_select (efl_util_gesture_h gesture_h, Evas_Object *window, efl_util_gesture_data data)
	Selects a global gesture on given window.
int	efl_util_gesture_deselect (efl_util_gesture_h gesture_h, Evas_Object *window, efl_util_gesture_data data)
	Deselects a global gesture on given window.
int	efl_util_gesture_activate_set (efl_util_gesture_h gesture_h, unsigned int type, Eina_Bool active)
	Activates or deactivates a global gesture.
int	efl_util_gesture_activate_set_on_window (efl_util_gesture_h gesture_h, Evas_Object *window, unsigned int type, Eina_Bool active)
	Activates or deactivates a global gesture on given window.
int	efl_util_gesture_edge_swipe_cb_set (efl_util_gesture_h gesture_h, efl_util_gesture_edge_swipe_cb cb_func, void *data)
	Set edge swipe gesture callback function of given efl util gesture handle.
int	efl_util_gesture_edge_drag_cb_set (efl_util_gesture_h gesture_h, efl_util_gesture_edge_drag_cb cb_func, void *data)
	Set edge drag gesture callback function of given efl util gesture handle.
int	efl_util_gesture_tap_cb_set (efl_util_gesture_h gesture_h, efl_util_gesture_tap_cb cb_func, void *data)
	Set tap gesture callback function of given efl util gesture handle.
int	efl_util_gesture_palm_cover_cb_set (efl_util_gesture_h gesture_h, efl_util_gesture_palm_cover_cb cb_func, void *data)
	Set palm cover gesture callback function of given efl util gesture handle.
Typedefs
typedef struct _efl_util_gesture_h *	efl_util_gesture_h
	Definition for the gesture handle.
typedef enum _efl_util_gesture_type_e	efl_util_gesture_type_e
	Enumeration of gesture type.
typedef enum _efl_util_gesture_mode_e	efl_util_gesture_mode_e
	Enumeration of gesture mode.
typedef enum _efl_util_gesture_edge_e	efl_util_gesture_edge_e
	Enumeration of gesture edge.
typedef enum _efl_util_gesture_edge_size_e	efl_util_gesture_edge_size_e
	Enumeration of gesture edge size.
typedef void *	efl_util_gesture_data
	Definition for the gesture data handle.
typedef struct _efl_util_event_gesture_edge_swipe_s	efl_util_event_gesture_edge_swipe_s
	Definition for the edge swipe gesture's event data structure.
typedef struct efl_util_event_gesture_edge_drag_s	efl_util_event_gesture_edge_drag_s
	Definition for the edge drag gesture's event data structure.
typedef struct _efl_util_event_gesture_tap_s	efl_util_event_gesture_tap_s
	Definition for the tap gesture's event data structure.
typedef struct _efl_util_event_gesture_palm_cover_s	efl_util_event_gesture_palm_cover_s
	Definition for the palm cover gesture's event data structure.

Typedef Documentation

typedef struct efl_util_event_gesture_edge_drag_s efl_util_event_gesture_edge_drag_s

Definition for the edge drag gesture's event data structure.

Since :: 4.0

typedef struct _efl_util_event_gesture_edge_swipe_s efl_util_event_gesture_edge_swipe_s

Definition for the edge swipe gesture's event data structure.

Since :: 4.0

typedef struct _efl_util_event_gesture_palm_cover_s efl_util_event_gesture_palm_cover_s

Definition for the palm cover gesture's event data structure.

Since :: 4.0

typedef struct _efl_util_event_gesture_tap_s efl_util_event_gesture_tap_s

Definition for the tap gesture's event data structure.

Since :: 4.0

typedef void* efl_util_gesture_data

Definition for the gesture data handle.

Since :: 4.0

typedef enum _efl_util_gesture_edge_e efl_util_gesture_edge_e

Enumeration of gesture edge.

Since :: 4.0

typedef enum _efl_util_gesture_edge_size_e efl_util_gesture_edge_size_e

Enumeration of gesture edge size.

Since :: 4.0

typedef struct _efl_util_gesture_h* efl_util_gesture_h

Definition for the gesture handle.

Since :: 4.0

typedef enum _efl_util_gesture_mode_e efl_util_gesture_mode_e

Enumeration of gesture mode.

Since :: 4.0

typedef enum _efl_util_gesture_type_e efl_util_gesture_type_e

Enumeration of gesture type.

Since :: 4.0

Enumeration Type Documentation

enum _efl_util_gesture_edge_e

Enumeration of gesture edge.

Since :: 4.0

Enumerator:

EFL_UTIL_GESTURE_EDGE_NONE	None edge point
EFL_UTIL_GESTURE_EDGE_TOP	Top edge position of screen
EFL_UTIL_GESTURE_EDGE_RIGHT	Right edge position of screen
EFL_UTIL_GESTURE_EDGE_BOTTOM	Bottom edge position of screen
EFL_UTIL_GESTURE_EDGE_LEFT	Left edge position of screen

enum _efl_util_gesture_edge_size_e

Enumeration of gesture edge size.

Since :: 4.0

Enumerator:

EFL_UTIL_GESTURE_EDGE_SIZE_NONE	None size of edge
EFL_UTIL_GESTURE_EDGE_SIZE_FULL	Full size in the edge
EFL_UTIL_GESTURE_EDGE_SIZE_PARTIAL	Part of edge

enum _efl_util_gesture_mode_e

Enumeration of gesture mode.

Since :: 4.0

Enumerator:

EFL_UTIL_GESTURE_MODE_NONE	None gesture mode
EFL_UTIL_GESTURE_MODE_BEGIN	Begin a gesture event
EFL_UTIL_GESTURE_MODE_UPDATE	continually update a gesture event
EFL_UTIL_GESTURE_MODE_END	End a gesture event
EFL_UTIL_GESTURE_MODE_DONE	Occur a gesture event

enum _efl_util_gesture_type_e

Enumeration of gesture type.

Since :: 4.0

Enumerator:

EFL_UTIL_GESTURE_TYPE_NONE	None gesture type
EFL_UTIL_GESTURE_TYPE_EDGE_SWIPE	Edge swipe gesture type
EFL_UTIL_GESTURE_TYPE_EDGE_DRAG	Edge drag gesture type
EFL_UTIL_GESTURE_TYPE_TAP	Tap gesture type
EFL_UTIL_GESTURE_TYPE_PALM_COVER	Palm cover gesture type
EFL_UTIL_GESTURE_TYPE_PAN	Pan gesture type
EFL_UTIL_GESTURE_TYPE_PINCH	Pinch gesture type
EFL_UTIL_GESTURE_TYPE_PALM_SWIPE	Palm swipe gesture type

Function Documentation

int efl_util_gesture_activate_set	(	efl_util_gesture_h	gesture_h,
		unsigned int	type,
		Eina_Bool	active
	)

Activates or deactivates a global gesture.

Warning:: This is not for use by third-party applications.

Since :: 4.0

Privilege Level:: platform

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

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	type	The gesture type to activate /deactivate combined by efl_util_gesture_type_e to bitwise operation
[in]	active	The activated boolean value

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_PERMISSION_DENIED	Permission denied
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_activate_set_on_window	(	efl_util_gesture_h	gesture_h,
		Evas_Object *	window,
		unsigned int	type,
		Eina_Bool	active
	)

Activates or deactivates a global gesture on given window.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	window	The efl window
[in]	type	The gesture type to activate /deactivate combined by efl_util_gesture_type_e to bitwise operation
[in]	active	The activated boolean value

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	Memory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_deinitialize ( efl_util_gesture_h gesture_h )

Deinitializes system.

Since :: 4.0

Parameters:

[in] gesture_h The efl_util_gesture_h handle

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_gesture_initialize()

int efl_util_gesture_deselect	(	efl_util_gesture_h	gesture_h,
		Evas_Object *	window,
		efl_util_gesture_data	data
	)

Deselects a global gesture on given window.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	window	The efl window
[in]	data	The efl_util_gesture_data handle

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	Memory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_edge_drag_cb_set	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_edge_drag_cb	cb_func,
		void *	data
	)

Set edge drag gesture callback function of given efl util gesture handle.

Since :: 7.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	cb_func	The callback function pointer
[in]	data	The 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

int efl_util_gesture_edge_drag_free	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_data	data
	)

Frees a memory of edge drag gesture's grab info handle.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	data	The efl_util_gesture_data handle

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_gesture_data efl_util_gesture_edge_drag_new	(	efl_util_gesture_h	gesture_h,
		unsigned int	fingers,
		efl_util_gesture_edge_e	edge
	)

Generates a edge drag gesture's grab info handle.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	fingers	The number of fingers
[in]	edge	The position of edge

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Returns:: efl_util_gesture_data on success, otherwise NULL

Return values:

efl_util_gesture_data The specific gesture data handle

Exceptions:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_edge_drag_size_set	(	efl_util_gesture_data	data,
		efl_util_gesture_edge_size_e	edge_size,
		unsigned int	start_point,
		unsigned int	end_point
	)

Sets a specific size of edge for edge drag gesture.

Since :: 4.0

Parameters:

[in]	data	The efl_util_gesture_data handle
[in]	edge_size	The efl_util_gesture_edge_size_e enum
[in]	start_point	The start point of edge area
[in]	end_point	The end point of edge area

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_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_edge_swipe_cb_set	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_edge_swipe_cb	cb_func,
		void *	data
	)

Set edge swipe gesture callback function of given efl util gesture handle.

Since :: 7.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	cb_func	The callback function pointer
[in]	data	The 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

int efl_util_gesture_edge_swipe_free	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_data	data
	)

Frees a memory of edge swipe gesture's grab info handle.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	data	The efl_util_gesture_data handle

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_gesture_data efl_util_gesture_edge_swipe_new	(	efl_util_gesture_h	gesture_h,
		unsigned int	fingers,
		efl_util_gesture_edge_e	edge
	)

Generates a edge swipe gesture's grab info handle.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	fingers	The number of fingers
[in]	edge	The position of edge

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Returns:: efl_util_gesture_data on success, otherwise NULL

Return values:

efl_util_gesture_data The specific gesture data handle

Exceptions:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_edge_swipe_size_set	(	efl_util_gesture_data	data,
		efl_util_gesture_edge_size_e	edge_size,
		unsigned int	start_point,
		unsigned int	end_point
	)

Sets a specific size of edge for edge swipe gesture.

Since :: 4.0

Parameters:

[in]	data	The efl_util_gesture_data handle
[in]	edge_size	The efl_util_gesture_edge_size_e enum
[in]	start_point	The start point of edge area
[in]	end_point	The end point of edge area

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_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_grab	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_data	data
	)

Grabs a global gesture.

Warning:: This is not for use by third-party applications.

Since :: 4.0

Privilege Level:: platform

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

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	data	The efl_util_gesture_data handle.

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_PERMISSION_DENIED	Permission denied
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_NOT_SUPPORTED	Not supported
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

efl_util_gesture_h efl_util_gesture_initialize ( void )

Initializes system and check if global gestures are supported.

Since :: 4.0

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Returns:: efl_util_gesture_h on success, otherwise NULL

Return values:

efl_util_gesture_h The global gesture handle

Exceptions:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_NOT_SUPPORTED	Not supported
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

See also:: efl_util_gesture_deinitialize()

int efl_util_gesture_palm_cover_cb_set	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_palm_cover_cb	cb_func,
		void *	data
	)

Set palm cover gesture callback function of given efl util gesture handle.

Since :: 7.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	cb_func	The callback function pointer
[in]	data	The 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

int efl_util_gesture_palm_cover_free	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_data	data
	)

Frees a memory of palm cover gesture's grab info handle.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	data	The efl_util_gesture_data handle

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_gesture_data efl_util_gesture_palm_cover_new ( efl_util_gesture_h gesture_h )

Generates a palm cover gesture's grab info handle.

Since :: 4.0

Parameters:

[in] gesture_h The efl_util_gesture_h handle

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Returns:: efl_util_gesture_data on success, otherwise NULL

Return values:

efl_util_gesture_data The specific gesture data handle

Exceptions:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_select	(	efl_util_gesture_h	gesture_h,
		Evas_Object *	window,
		efl_util_gesture_data	data
	)

Selects a global gesture on given window.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	window	The efl window
[in]	data	The efl_util_gesture_data handle.

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	Memory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_tap_cb_set	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_tap_cb	cb_func,
		void *	data
	)

Set tap gesture callback function of given efl util gesture handle.

Since :: 7.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	cb_func	The callback function pointer
[in]	data	The 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

int efl_util_gesture_tap_free	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_data	data
	)

Frees a memory of tap gesture's grab info handle.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	data	The efl_util_gesture_data handle

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_gesture_data efl_util_gesture_tap_new	(	efl_util_gesture_h	gesture_h,
		unsigned int	fingers,
		unsigned int	repeats
	)

Generates a tap gesture's grab info handle.

Since :: 4.0

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	fingers	The number of fingers
[in]	repeats	The number of repeats

Remarks:: The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.

Returns:: efl_util_gesture_data on success, otherwise NULL

Return values:

efl_util_gesture_data The specific gesture data handle

Exceptions:

EFL_UTIL_ERROR_NONE	Successful
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_INVALID_PARAMETER	Invalid parameter
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

int efl_util_gesture_ungrab	(	efl_util_gesture_h	gesture_h,
		efl_util_gesture_data	data
	)

Ungrabs a global gesture.

Warning:: This is not for use by third-party applications.

Since :: 4.0

Privilege Level:: platform

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

Parameters:

[in]	gesture_h	The efl_util_gesture_h handle
[in]	data	The efl_util_gesture_data handle.

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_PERMISSION_DENIED	Permission denied
EFL_UTIL_ERROR_OUT_OF_MEMORY	Memory allocation failure
EFL_UTIL_ERROR_NOT_SUPPORTED	Not supported
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLE	Resource is not available

Variable Documentation

int EFL_UTIL_EVENT_GESTURE_EDGE_DRAG

Definition for the edge swipe gesture event.

Since :: 4.0

int EFL_UTIL_EVENT_GESTURE_EDGE_SWIPE

Definition for the edge swipe gesture event.

Since :: 4.0

int EFL_UTIL_EVENT_GESTURE_PALM_COVER

Definition for the palm cover gesture event.

Since :: 4.0

int EFL_UTIL_EVENT_GESTURE_TAP

Definition for the tap gesture event.

Since :: 4.0

Required Header

Overview

Grabbing Gestures

Selecting Gestures

Deactivating Gestures

Deactivating Gestures in a Window

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation

Variable Documentation