Tizen Native API  9.0
EFL UTIL GESTURE

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)
 Sets 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)
 Sets 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)
 Sets 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)
 Sets 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 void(* efl_util_gesture_edge_swipe_cb )(void *user_data, int mode, int fingers, int sx, int sy, int edge)
 Handle for the callback function of edge swipe gesture.
typedef void(* efl_util_gesture_edge_drag_cb )(void *user_data, int mode, int fingers, int cx, int cy, int edge)
 Handle for the callback function of edge drag gesture.
typedef void(* efl_util_gesture_tap_cb )(void *user_data, int mode, int fingers, int repeats)
 Handle for the callback function of tap gesture.
typedef void(* efl_util_gesture_palm_cover_cb )(void *user_data, int mode, int duration, int cx, int cy, int size, double pressure)
 Handle for the callback function of palm cover gesture.

Typedef Documentation

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

Since :
4.0

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

Since :
4.0

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

Since :
4.0

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 void(* efl_util_gesture_edge_drag_cb)(void *user_data, int mode, int fingers, int cx, int cy, int edge)

Handle for the callback function of edge drag gesture.

Since :
7.0
Parameters:
[in]user_dataThe data to be passed to the callback function
[in]modeThe mode of a gesture event
[in]fingersThe number of fingers
[in]cxThe center x point of edge area
[in]cyThe center y point of edge area
[in]edgeThe position of edge

Enumeration of gesture edge.

Since :
4.0

Enumeration of gesture edge size.

Since :
4.0
typedef void(* efl_util_gesture_edge_swipe_cb)(void *user_data, int mode, int fingers, int sx, int sy, int edge)

Handle for the callback function of edge swipe gesture.

Since :
7.0
Parameters:
[in]user_dataThe data to be passed to the callback function
[in]modeThe mode of a gesture event
[in]fingersThe number of fingers
[in]sxThe start x point of edge area
[in]syThe start y point of edge area
[in]edgeThe position of edge
typedef struct _efl_util_gesture_h* efl_util_gesture_h

Definition for the gesture handle.

Since :
4.0

Enumeration of gesture mode.

Since :
4.0
typedef void(* efl_util_gesture_palm_cover_cb)(void *user_data, int mode, int duration, int cx, int cy, int size, double pressure)

Handle for the callback function of palm cover gesture.

Since :
7.0
Parameters:
[in]user_dataThe data to be passed to the callback function
[in]modeThe mode of a gesture event
[in]durationThe duration time of gesture behavior
[in]cxThe center x point of palm covered area
[in]cyThe center y point of palm covered area
[in]sizeThe size of palm covered area
[in]pressureThe pressure of touched finger
typedef void(* efl_util_gesture_tap_cb)(void *user_data, int mode, int fingers, int repeats)

Handle for the callback function of tap gesture.

Since :
7.0
Parameters:
[in]user_dataThe data to be passed to the callback function
[in]modeThe mode of a gesture event
[in]fingersThe number of fingers
[in]repeatsThe number of repeats

Enumeration of gesture type.

Since :
4.0

Enumeration Type Documentation

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

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

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

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_hThe efl_util_gesture_h handle
[in]typeThe gesture type to activate /deactivate combined by efl_util_gesture_type_e to bitwise operation
[in]activeThe activated boolean value
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource 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_hThe efl_util_gesture_h handle
[in]windowThe efl window
[in]typeThe gesture type to activate /deactivate combined by efl_util_gesture_type_e to bitwise operation
[in]activeThe activated boolean value
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available

Deinitializes system.

Since :
4.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
See also:
efl_util_gesture_initialize()

Deselects a global gesture on given window.

Since :
4.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]windowThe efl window
[in]dataThe efl_util_gesture_data handle
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available

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

Since :
7.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]cb_funcThe callback function pointer
[in]dataThe data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter

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

Since :
4.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]dataThe efl_util_gesture_data handle
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter

Generates a edge drag gesture's grab info handle.

Since :
4.0
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]fingersThe number of fingers
[in]edgeThe position of edge
Returns:
efl_util_gesture_data on success, otherwise NULL
Exceptions:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource 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]dataThe efl_util_gesture_data handle
[in]edge_sizeThe efl_util_gesture_edge_size_e enum
[in]start_pointThe start point of edge area
[in]end_pointThe end point of edge area
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available

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

Since :
7.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]cb_funcThe callback function pointer
[in]dataThe data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter

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

Since :
4.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]dataThe efl_util_gesture_data handle
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter

Generates a edge swipe gesture's grab info handle.

Since :
4.0
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]fingersThe number of fingers
[in]edgeThe position of edge
Returns:
efl_util_gesture_data on success, otherwise NULL
Exceptions:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource 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]dataThe efl_util_gesture_data handle
[in]edge_sizeThe efl_util_gesture_edge_size_e enum
[in]start_pointThe start point of edge area
[in]end_pointThe end point of edge area
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available

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_hThe efl_util_gesture_h handle
[in]dataThe efl_util_gesture_data handle.
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_NOT_SUPPORTEDNot supported
EFL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available

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.
The returned object should be released with efl_util_gesture_deinitialize().
Returns:
efl_util_gesture_h on success, otherwise NULL
Exceptions:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_NOT_SUPPORTEDNot supported
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available
See also:
efl_util_gesture_deinitialize()

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

Since :
7.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]cb_funcThe callback function pointer
[in]dataThe data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter

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

Since :
4.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]dataThe efl_util_gesture_data handle
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter

Generates a palm cover gesture's grab info handle.

Since :
4.0
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
Returns:
efl_util_gesture_data on success, otherwise NULL
Exceptions:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available

Selects a global gesture on given window.

Since :
4.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]windowThe efl window
[in]dataThe efl_util_gesture_data handle.
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource 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 
)

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

Since :
7.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]cb_funcThe callback function pointer
[in]dataThe data to be passed to the callback function
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter

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

Since :
4.0
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]dataThe efl_util_gesture_data handle
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid 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
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Parameters:
[in]gesture_hThe efl_util_gesture_h handle
[in]fingersThe number of fingers
[in]repeatsThe number of repeats
Returns:
efl_util_gesture_data on success, otherwise NULL
Exceptions:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available

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_hThe efl_util_gesture_h handle
[in]dataThe efl_util_gesture_data handle.
Returns:
0 on success, otherwise a negative error value
Return values:
EFL_UTIL_ERROR_NONESuccessful
EFL_UTIL_ERROR_NOT_SUPPORTEDNot supported
EFL_UTIL_ERROR_PERMISSION_DENIEDPermission denied
EFL_UTIL_ERROR_INVALID_PARAMETERInvalid parameter
EFL_UTIL_ERROR_OUT_OF_MEMORYMemory allocation failure
EFL_UTIL_ERROR_NO_RESOURCE_AVAILABLEResource is not available

Variable Documentation

Definition for the edge drag gesture event.

Since :
4.0

Definition for the edge swipe gesture event.

Since :
4.0

Definition for the palm cover gesture event.

Since :
4.0

Definition for the tap gesture event.

Since :
4.0