Tizen Native API
9.0
|
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
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 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_data The data to be passed to the callback function [in] mode The mode of a gesture event [in] fingers The number of fingers [in] cx The center x point of edge area [in] cy The center y point of edge area [in] edge The position of edge
typedef enum _efl_util_gesture_edge_e efl_util_gesture_edge_e |
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_data The data to be passed to the callback function [in] mode The mode of a gesture event [in] fingers The number of fingers [in] sx The start x point of edge area [in] sy The start y point of edge area [in] edge The position of edge
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 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_data The data to be passed to the callback function [in] mode The mode of a gesture event [in] duration The duration time of gesture behavior [in] cx The center x point of palm covered area [in] cy The center y point of palm covered area [in] size The size of palm covered area [in] pressure The 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_data The data to be passed to the callback function [in] mode The mode of a gesture event [in] fingers The number of fingers [in] repeats The number of repeats
typedef enum _efl_util_gesture_type_e efl_util_gesture_type_e |
Enumeration of gesture type.
- Since :
- 4.0
Enumeration Type Documentation
Enumeration of gesture edge.
- Since :
- 4.0
Enumeration of gesture mode.
- Since :
- 4.0
Enumeration of gesture type.
- Since :
- 4.0
- Enumerator:
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_PERMISSION_DENIED Permission denied 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_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 | ||
) |
Sets 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
- Remarks:
- The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- Parameters:
-
[in] gesture_h The efl_util_gesture_h handle [in] fingers The number of fingers [in] edge The position of edge
- Returns:
- efl_util_gesture_data on success, otherwise
NULL
- Exceptions:
-
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_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 | ||
) |
Sets 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
- Remarks:
- The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- Parameters:
-
[in] gesture_h The efl_util_gesture_h handle [in] fingers The number of fingers [in] edge The position of edge
- Returns:
- efl_util_gesture_data on success, otherwise
NULL
- 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_NOT_SUPPORTED Not supported EFL_UTIL_ERROR_PERMISSION_DENIED Permission denied 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
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_NONE Successful EFL_UTIL_ERROR_NOT_SUPPORTED Not supported EFL_UTIL_ERROR_OUT_OF_MEMORY Memory allocation failure 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 | ||
) |
Sets 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
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_h The efl_util_gesture_h handle
- Returns:
- efl_util_gesture_data on success, otherwise
NULL
- Exceptions:
-
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_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 | ||
) |
Sets 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
- Remarks:
- The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
- Parameters:
-
[in] gesture_h The efl_util_gesture_h handle [in] fingers The number of fingers [in] repeats The number of repeats
- Returns:
- efl_util_gesture_data on success, otherwise
NULL
- Exceptions:
-
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_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_NOT_SUPPORTED Not supported EFL_UTIL_ERROR_PERMISSION_DENIED Permission denied 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
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